Examples

Examples

Complete, runnable Go examples live in the agent-assembly-examples repository. Each is a self-contained Go module with its own README.md. This section walks through every Go example in depth: what it demonstrates, how the governance flow works, the real commands to run it, and an annotated tour of the code.

Start with Preparing the runtime environment for the one-time setup every example shares, then pick the example that matches what you’re building.

How the SDK wraps tool calls

Every example follows the same shape as the Quick Start: tag the context with an agent ID, then wrap your tools with a GovernanceClient so each call is checked against a policy before it runs and recorded after it finishes.

import (
    "context"
    "fmt"

    "github.com/ai-agent-assembly/go-sdk/assembly"
)

func main() {
    ctx := assembly.WithAgentID(context.Background(), "my-agent")

    // The examples in this section use an in-process mock GovernanceClient so
    // they run offline. In production you pass a transport-backed client that
    // reaches your gateway.
    client := &mockClient{}

    governed := assembly.WrapTools([]assembly.Tool{myTool}, client)
    // hand `governed` to your agent — every Call is now governed
    result, err := governed[0].Call(ctx, "input")
    fmt.Println(result, err)
}

These examples run offline. To keep them runnable in CI without a live gateway, every example here passes an in-process mock GovernanceClient to WrapTools. The wrapping logic is identical to production — swap the mock for a transport-backed client and the same code governs real tool access. See Configuration for connecting to a real gateway.

In this section

Each example’s README.md in the examples repo has the canonical step-by-step instructions; these pages add the walkthrough.

Where to next

• Quick Start — the three-step path these examples build on.
• Guides — task-first walkthroughs of wrapping tools, framework integration, and handling decisions.
• Configuration — every Init option, defaults, and enforcement modes.