react

func NewAgent ¶

func NewAgent(
	llm model.AgenticModel,
	modelMaxTokensK int,
	manager contextmgr.ContextManager,
) *Agent

NewAgent creates a tool-calling agent backed by Eino's model.AgenticModel.

The agent intentionally trusts the AgenticModel contract and does not branch on OpenAI/Claude/Gemini-specific message quirks. Provider differences should be handled by the Eino agentic model implementations and provider-specific model.Option values passed by callers.

Typical provider construction:

OpenAI Responses API:

import (
    "github.com/cloudwego/eino-ext/components/model/agenticopenai"
)

llm, err := agenticopenai.NewResponsesModel(ctx, &agenticopenai.ResponsesConfig{
    APIKey: "sk-...",
    Model:  "gpt-5.2",
    // BaseURL is optional for OpenAI-compatible gateways.
    // ByAzure can be set when using Azure OpenAI.
})
agent := react.NewAgent(llm, 128, nil)

Claude:

import (
    "github.com/cloudwego/eino-ext/components/model/agenticclaude"
)

llm, err := agenticclaude.New(ctx, &agenticclaude.Config{
    APIKey:    "sk-ant-...",
    Model:     "claude-sonnet-4-5",
    MaxTokens: 4096,
    // ByBedrock or ByGoogleVertexAI can be set for hosted Claude.
})
agent := react.NewAgent(llm, 128, nil)

Gemini on Vertex AI:

import (
    "cloud.google.com/go/auth/credentials"
    "github.com/cloudwego/eino-ext/components/model/agenticgemini"
    "google.golang.org/genai"
    "os"
)

client, err := genai.NewClient(ctx, &genai.ClientConfig{
    Backend:  genai.BackendVertexAI,
    Project:  "your-gcp-project",
    Location: "global", // or a region such as "us-central1"
    // Credentials may be omitted when Application Default Credentials are available.
})

// Or initialize Vertex AI with service account credentials JSON.
credentialsJSON, err := os.ReadFile("/path/to/service-account.json")
if err != nil {
    return err
}
creds, err := credentials.DetectDefault(&credentials.DetectOptions{
    Scopes:          []string{"https://www.googleapis.com/auth/cloud-platform"},
    CredentialsJSON: credentialsJSON,
})
if err != nil {
    return err
}
client, err = genai.NewClient(ctx, &genai.ClientConfig{
    Backend:     genai.BackendVertexAI,
    Project:     "your-gcp-project",
    Location:    "global",
    Credentials: creds,
})

llm, err := agenticgemini.New(ctx, &agenticgemini.Config{
    Client: client,
    Model:  "gemini-2.5-flash",
})
agent := react.NewAgent(llm, 128, nil)

Gemini Developer API uses the same agenticgemini model with a genai client configured by API key instead of BackendVertexAI.