Ingenimax/agent-sdk-go

Ingenimax / agent-sdk-go – 用于构建AI代理的Go SDK

它是什么

• 一个Go库（以及附带的CLI），让您可以组装生产级AI代理。它封装了大语言模型（LLM）提供商（OpenAI、Anthropic、Google Vertex AI），并添加了企业级代理中常见的功能工具箱：持久内存、工具调用、多代理编排、护栏、可观测性和多租户隔离。

关键能力

领域	SDK提供的内容
LLM集成	即插即用的OpenAI、Anthropic、Gemini客户端；令牌使用报告；通过HTTP/SSE或stdio支持模型上下文协议（MCP）。
内存	对话缓冲区、基于向量的检索、摘要、事实整合，以及持久存储后端（内存、SQLite、Postgres、Redis）。
工具	内置网络搜索工具、计算器，以及自定义工具注册表。代理在需要时自动调用工具。
代理编排	用YAML定义代理，按顺序、并行、循环或图形模式组合它们，并让模型将对话转移到更合适的子代理。
企业功能	安全护栏、追踪/日志记录、多租户隔离、用于审计或重写工具调用的钩子/插件系统、后台运行管理，以及令牌成本跟踪。
开发者体验	声明式YAML配置、从系统提示自动生成代理设置、结构化任务框架、带JSON/JUnit报告的版本化评估数据集。

如何使用

1. 添加库 – go get github.com/Ingenimax/agent-sdk-go。
2. 创建LLM客户端（例如，openai.NewClient(apiKey)）。
3. 通过tools.NewRegistry()注册工具，并可选择添加内置网络搜索工具。
4. 使用agent.NewAgent实例化代理，传入LLM、内存、工具、系统提示等。
5. 运行代理 – 调用agent.Run(ctx, "your query")或使用提供的agent-cli启动交互式聊天。

配置

• 环境变量（例如，OPENAI_API_KEY、REDIS_ADDRESS）驱动SDK。
• 完整的YAML模式让您可以描述代理、任务、内存后端、MCP服务器，甚至响应JSON模式。
• 示例YAML展示了分层代理、子代理和运行时设置。

CLI

• agent-cli init创建入门配置。
• agent-cli run "question"执行单个查询。
• agent-cli chat打开交互式REPL。
• CLI可以从预构建二进制、go install或使用make build-cli本地构建安装。

生态系统

• 文档站点：https://docs.goagents.dev/
• 名为Nina的AI助手可以通过MCP连接到IDE内帮助（Cursor、Claude Desktop）。
• 项目支持可选的Redis用于分布式内存，并提供自定义审计钩子。

适用对象

• 需要现成框架来构建基于聊天的助手、研究机器人或任何将LLM推理与外部工具结合的工作流的Go开发者。
• 寻找企业级功能（多租户、护栏、可观测性）而无需从头开始接线的团队。

底线 Ingenimax的agent-sdk-go是一个全面、面向生产的Go工具包，用于构建、配置和运行能够调用工具、记住上下文并安全大规模运行的AI代理。