Skip to content

Getting Started

Getting Started

A short walk-through of installing the SDK, initialising it, and confirming that a tool call is reaching the AI Agent Assembly gateway.

Prerequisites

  • Go ≥ 1.26 (matches the floor declared in go.mod)
  • An AAASM gateway URL and API key (see your operator)
  • (Optional) a C compiler if you want to enable the native FFI transport with -tags aa_ffi_go. The default transport is pure-Go and needs none.

Install 

go get github.com/ai-agent-assembly/go-sdk

Initialise 

ctx, err := assembly.Init(context.Background(),
    assembly.WithGatewayURL("https://gateway.example.com"),
    assembly.WithAPIKey("..."),
    assembly.WithFailClosed(false),
)
if err != nil {
    log.Fatal(err)
}
defer ctx.Close()

Wrap your tools 

wrapped := assembly.WrapTools(myTools, ctx)

Each call against wrapped is checked against the gateway policy before execution and recorded after.

Where to next