Agent Go SDK

一个功能强大的 Go 框架，旨在构建生产级的 AI Agent！它将内存管理、工具执行、多 LLM 支持以及企业级功能无缝集成到一个灵活且可扩展的架构中。

文档

📖 docs.goagents.dev — 包含完整的文档、指南和参考手册。

社区

加入我们的 Discord 服务器，与他人协作、分享你的构建成果，并获取 agent-sdk-go 的社区支持！

特性

核心能力

• 🧠 多模型智能：与 OpenAI、Anthropic 和 Google Vertex AI (Gemini 模型) 无缝集成。
• 🔧 模块化工具生态：通过即插即用的工具扩展 Agent 功能，支持网页搜索、数据检索和自定义操作。
• 📝 高级内存管理：提供基于缓冲区 (buffer) 和向量 (vector) 的检索选项，实现持续的对话追踪。
• 🔌 MCP 集成：通过 HTTP 和 stdio 传输支持 Model Context Protocol (MCP) 服务器。
• 📊 Token 使用跟踪：内置 Token 计算功能，用于成本监控、使用分析和性能优化。

企业级就绪

• 🚦 内置护栏 (Guardrails)：全面的安全机制，确保负责任的 AI 部署。
• 📈 完整的可观测性：集成了追踪 (tracing) 和日志记录功能，便于监控和调试。
• 🏢 企业级多租户：安全地支持多组织环境，实现资源隔离。

开发体验

• 🛠️ 结构化任务框架：支持复杂多步操作的计划、审批与执行。
• 📄 声明式配置：使用直观的 YAML 定义来配置复杂的 Agent 和任务。
• 🧙 零门槛引导：通过简单的系统提示词 (system prompts) 自动生成完整的 Agent 配置。

入门指南

前置要求

• Go 1.23+
• Redis（可选，用于分布式内存）

安装

作为 Go 库使用

将 SDK 添加到你的 Go 项目中：

go get github.com/Ingenimax/agent-sdk-go

作为 CLI 工具使用 (Headless SDK)

选项 1：下载预编译二进制文件（推荐）

从 GitHub Releases 下载适合你平台的最新版本，并将其添加到 PATH 中。

选项 2：通过 Go 安装

go install github.com/Ingenimax/agent-sdk-go/cmd/agent-cli@latest

选项 3：从源码构建

# 克隆仓库
git clone https://github.com/Ingenimax/agent-sdk-go
cd agent-sdk-go

# 构建 CLI 工具
make build-cli

# 安装到系统 PATH（可选）
make install

CLI 快速开始：

# 初始化配置
agent-cli init

# 选项 1：设置环境变量
export OPENAI_API_KEY=your_api_key_here

# 选项 2：使用 .env 文件（推荐）
cp env.example .env
# 编辑 .env 文件并填入你的 API Key

# 运行一个简单的查询
agent-cli run "What's the weather in San Francisco?"

# 启动交互式聊天
agent-cli chat

配置

SDK 使用环境变量进行配置，关键变量包括：

• OPENAI_API_KEY：你的 OpenAI API Key
• OPENAI_MODEL：使用的模型（例如：gpt-4o-mini）
• LOG_LEVEL：日志级别（debug, info, warn, error）
• REDIS_ADDRESS：Redis 服务器地址（如果使用 Redis 进行内存存储）

详细配置选项请参阅 .env.example。

通过 Nina (AI 助手) 获取帮助

Nina 是一位精通 agent-sdk-go 代码库的 AI 助手。通过 MCP (Model Context Protocol) 连接 Nina，直接在你的 IDE 中获取帮助。

Cursor IDE

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "agent-sdk-go": {
      "url": "https://nina.agentgogo.app/mcp",
      "transport": "sse"
    }
  }
}

重启 Cursor IDE，Nina 的工具即可在 AI 助手中使用。

Claude Desktop

添加到 claude_desktop_config.json：

平台	配置位置
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "agent-sdk-go": {
      "url": "https://nina.agentgogo.app/mcp",
      "transport": "sse"
    }
  }
}

重启 Claude Desktop，Nina 的工具将通过 🔌 图标提供。

可用工具

工具	描述
ask_nina	询问有关 agent-sdk-go、Go 编程或开发的问题
search_sdk	搜索 SDK 文档和源代码
get_sdk_status	获取 Nina 的 SDK 知识库状态

使用示例

创建一个简单的 Agent

package main

import (
	"context"
	"fmt"

	"github.com/Ingenimax/agent-sdk-go/pkg/agent"
	"github.com/Ingenimax/agent-sdk-go/pkg/config"
	"github.com/Ingenimax/agent-sdk-go/pkg/llm/openai"
	"github.com/Ingenimax/agent-sdk-go/pkg/logging"
	"github.com/Ingenimax/agent-sdk-go/