Agno-Go

简体中文

English
日本語
한국어

简体中文

English
日本語
한국어

Appearance

版本发布说明 ​

Version 1.2.1 (2025-10-15) ​

🧭 文档重组 ​

  • 明确区分：
    • website/ → 已实现的对外文档（VitePress 网站）
    • docs/ → 设计草案、迁移计划、任务与开发者/内部文档
  • 新增 docs/README.md 说明策略与入口
  • 新增 CONTRIBUTING.md 方便贡献者上手

🔗 链接修复 ​

  • README、CLAUDE、CHANGELOG 与发布说明链接统一指向 website/advanced/* 与 website/guide/*
  • 移除指向 docs/ 下重复实现文档的旧链接

🌐 网站更新 ​

  • API：在 AgentOS 页面补充知识库 API（/api/agentos）
  • 确认 Workflow History、Performance 页面为规范引用

✅ 行为变更 ​

  • 无（仅文档与结构调整）

✨ 本次新增（已实现） ​

  • A2A 流式端点事件类型过滤（SSE）
    • POST /api/v1/agents/:id/run/stream?types=token,complete
    • 仅输出所请求的事件类型；标准 SSE 格式；支持 Context 取消
  • AgentOS 内容抽取中间件
    • 将 JSON/Form 中的 content/metadata/user_id/session_id 注入上下文
    • 支持 MaxRequestSize 请求大小保护与路径跳过
  • Google Sheets 工具（服务账号）
    • 提供 read_range、write_range、append_rows，支持 JSON/文件凭证
  • 最小化知识入库端点
    • POST /api/v1/knowledge/content 支持 text/plain 与 application/json

企业验收步骤请参考 docs/ENTERPRISE_MIGRATION_PLAN.md。

Version 1.1.0 (2025-10-08) ​

🎉 重点功能 ​

本版本为生产级多智能体系统带来强大的新功能：

  • A2A 接口 - 标准化的 Agent 间通信协议
  • Session State 管理 - 工作流步骤间的持久化状态
  • 多租户支持 - 单个 Agent 实例服务多个用户
  • 模型超时配置 - LLM 调用的细粒度超时控制

✨ 新功能 ​

A2A (Agent-to-Agent) 接口 ​

基于 JSON-RPC 2.0 的标准化 Agent 间通信协议。

核心特性：

  • REST API 端点（/a2a/message/send、/a2a/message/stream）
  • 多媒体支持（文本、图片、文件、JSON 数据）
  • Server-Sent Events (SSE) 流式传输
  • 与 Python Agno A2A 实现兼容

快速示例：

go
import "github.com/rexleimo/agno-go/pkg/agentos/a2a"

// 创建 A2A 接口
a2a := a2a.New(a2a.Config{
    Agents: []a2a.Entity{myAgent},
    Prefix: "/a2a",
})

// 注册路由 (Gin)
router := gin.Default()
a2a.RegisterRoutes(router)

📚 了解更多： A2A 接口文档

Workflow Session State 管理 ​

线程安全的会话管理，用于在工作流步骤间维护状态。

核心特性：

  • 跨步骤持久化状态存储
  • 使用 sync.RWMutex 的线程安全
  • 并行分支隔离的深拷贝
  • 智能合并策略防止数据丢失
  • 修复 Python Agno v2.1.2 的竞态条件

快速示例：

go
// 创建带会话信息的上下文
execCtx := workflow.NewExecutionContextWithSession(
    "input",
    "session-123",  // Session ID
    "user-a",       // User ID
)

// 访问会话状态
execCtx.SetSessionState("key", "value")
value, _ := execCtx.GetSessionState("key")

📚 了解更多： Session State 文档

多租户支持 ​

用单个 Agent 实例服务多个用户，同时确保数据完全隔离。

核心特性：

  • 用户隔离的对话历史
  • Memory 接口支持可选的 userID 参数
  • 向后兼容现有代码
  • 线程安全的并发操作
  • 用于清理的 ClearAll() 方法

快速示例：

go
// 创建多租户 Agent
agent, _ := agent.New(&agent.Config{
    Name:   "customer-service",
    Model:  model,
    Memory: memory.NewInMemory(100),
})

// User A 的对话
agent.UserID = "user-a"
output, _ := agent.Run(ctx, "我叫 Alice")

// User B 的对话
agent.UserID = "user-b"
output, _ := agent.Run(ctx, "我叫 Bob")

📚 了解更多： 多租户文档

模型超时配置 ​

为 LLM 调用配置请求超时，提供细粒度控制。

核心特性：

  • 默认值：60 秒
  • 范围：1 秒到 10 分钟
  • 支持的模型：OpenAI、Anthropic Claude
  • 上下文感知的超时处理

快速示例：

go
// OpenAI 自定义超时
model, _ := openai.New("gpt-4", openai.Config{
    APIKey:  apiKey,
    Timeout: 30 * time.Second,
})

// Claude 自定义超时
claude, _ := anthropic.New("claude-3-opus", anthropic.Config{
    APIKey:  apiKey,
    Timeout: 45 * time.Second,
})

📚 了解更多： 模型配置

🐛 Bug 修复 ​

  • Workflow 竞态条件 - 修复并行步骤执行的数据竞争
    • Python Agno v2.1.2 有共享的 session_state 字典导致覆盖
    • Go 实现为每个分支使用独立的 SessionState 克隆
    • 智能合并策略防止并发执行中的数据丢失

📚 文档 ​

所有新功能都包含完整的双语文档（English/中文）：

🧪 测试 ​

新测试套件：

  • session_state_test.go - 543 行会话状态测试
  • memory_test.go - 多租户内存测试（4 个新测试用例）
  • agent_test.go - 多租户 Agent 测试
  • openai_test.go - 超时配置测试
  • anthropic_test.go - 超时配置测试

测试结果：

  • ✅ 所有测试通过 -race 检测器
  • ✅ Workflow 覆盖率：79.4%
  • ✅ Memory 覆盖率：93.1%
  • ✅ Agent 覆盖率：74.7%

📊 性能 ​

无性能回归 - 所有基准测试保持一致：

  • Agent 实例化：~180ns/op（比 Python 快 16 倍）
  • 内存占用：~1.2KB/agent
  • 线程安全的并发操作

⚠️ 破坏性变更 ​

无。 此版本与 v1.0.x 完全向后兼容。

🔄 迁移指南 ​

无需迁移 - 所有新功能都是附加的且向后兼容。

可选增强：

  1. 启用多租户支持：

    go
    // 在 Agent 配置中添加 UserID
agent := agent.New(agent.Config{
    UserID: "user-123",  // 新增
    Memory: memory.NewInMemory(100),
})

  2. 在 Workflow 中使用 Session State：

    go
    // 创建带会话的上下文
ctx := workflow.NewExecutionContextWithSession(
    "input",
    "session-id",
    "user-id",
)

  3. 配置模型超时：

    go
    // 在模型配置中添加 Timeout
model, _ := openai.New("gpt-4", openai.Config{
    APIKey:  apiKey,
    Timeout: 30 * time.Second,  // 新增
})

📦 安装 ​

bash
go get github.com/rexleimo/agno-go@v1.1.0

🔗 链接 ​

Version 1.0.3 (2025-10-06) ​

🧪 改进 ​

测试与质量 ​

  • 增强 JSON 序列化测试 - utils/serialize 包达到 100% 测试覆盖率
  • 性能基准测试 - 与 Python Agno 性能测试模式对齐
  • 全面文档 - 添加双语包文档

性能 ​

  • ToJSON: ~600ns/op, 760B/op, 15 allocs/op
  • ConvertValue: ~180ns/op, 392B/op, 5 allocs/op
  • Agent Creation: ~180ns/op（比 Python 快 16 倍）

Version 1.0.2 (2025-10-05) ​

✨ 新增 ​

GLM (智谱AI) 提供商 ​

  • 完整集成智谱 AI 的 GLM 模型
  • 支持 GLM-4、GLM-4V（视觉）、GLM-3-Turbo
  • 自定义 JWT 认证（HMAC-SHA256）
  • 同步和流式 API 调用
  • 工具/函数调用支持
  • 测试覆盖率：57.2%

快速示例：

go
model, _ := glm.New("glm-4", glm.Config{
    APIKey:      os.Getenv("ZHIPUAI_API_KEY"),
    Temperature: 0.7,
})

Version 1.0.0 (2025-10-02) ​

🎉 初始版本 ​

Agno-Go v1.0 是 Agno 多智能体框架的高性能 Go 实现。

核心功能 ​

  • Agent - 带工具支持的单个自主 Agent（74.7% 覆盖率）
  • Team - 4 种模式的多 Agent 协作（92.3% 覆盖率）
  • Workflow - 5 种原语的基于步骤的编排（80.4% 覆盖率）

LLM 提供商 ​

  • OpenAI（GPT-4、GPT-3.5、GPT-4 Turbo）
  • Anthropic（Claude 3.5 Sonnet、Claude 3 Opus/Sonnet/Haiku）
  • Ollama（本地模型）

工具与存储 ​

  • Calculator、HTTP、File 工具
  • 内存对话存储（93.1% 覆盖率）
  • 会话管理
  • ChromaDB 向量数据库

性能 ​

  • Agent 创建：~180ns/op（比 Python 快 16 倍）
  • 内存占用：~1.2KB/agent
  • 测试覆盖率：平均 80.8%

之前的版本 ​

完整版本历史请参见 CHANGELOG.md。

最后更新： 2025-10-08

Released under the MIT License.

Copyright © 2025 Agno-Go Team