本文对AgentKit SDK进行简要介绍，包含其核心架构设计、模块依赖关系及主要特性等。 ## SDK介绍 AgentKit SDK是一个Python开发工具包，用于快速构建符合AgentKit标准的Agent应用。SDK提供了一套简洁的装饰器和客户端接口（[AgentKit API概览](https://www.volcengine.com/docs/86681/1913769)），帮助开发者专注于Agent业务逻辑的实现及资源的创建和管理。 ## SDK地址 |编程语言 |Github地址 |指导文档 | |---|---|---| |Python |[agentkit-sdk-python](https://github.com/volcengine/agentkit-sdk-python) |[安装指导](https://volcengine.github.io/agentkit-sdk-python/content/1.introduction/2.installation.html) | ## 核心架构 AgentKit SDK采用模块化设计，主要包含以下模块： ### Runtime应用框架提供多种应用模式，将用户代码封装为符合AgentKit标准的HTTP服务： #### AgentKitSimpleApp 最常用的应用框架，适用于标准的Agent应用。 **核心装饰器**： * `@app.entrypoint`：定义Agent的主入口函数。 * `@app.ping`：定义健康检查函数。 **标准路由**： * `/invoke`：Agent调用端点。 * `/ping`：健康检查。 * `/health`、`/readiness`、`/liveness`：Kubernetes就绪探针。 #### AgentKitMCPApp 基于MCP（Model Context Protocol）协议的应用框架，用于将工具封装为MCP服务。 **核心装饰器**： * `@app.tool`：将函数注册为MCP工具。 * `@app.agent_as_a_tool`：将Agent封装为MCP工具。 #### AgentKitA2aApp 基于A2A（Agent\-to\-Agent）协议的应用框架，用于构建可互相通信的Agent。 **核心装饰器**： * `@app.agent_executor`：注册Agent执行器。 * `@app.task_store`：注册任务存储（可选）。 #### AgentkitAgentServerApp Agentkit SDK提供的高级应用框架，适用于适配Google ADK Web Server的Agent应用。 **标准路由** * **`/sessions`**：会话创建断点。 * **`/run_sse`**：Agent对话端点。 * **`/invoke`** **：** 兼容AgetnkitSimpleApp的Agent对话端点。 **核心装饰器** 无注解，用于完整服务器应用。 ### AgentKit服务客户端提供便捷的客户端接口，用于访问AgentKit Platform的各项服务。 #### AgentKitMemory 记忆服务客户端，管理Agent的长期和短期记忆。 **主要功能**： * `create_memory_collection()`：创建记忆库。 * `list_memory_collections()`：列举记忆库。 * `get_memory_collection()`：获取记忆库详情。 * `update_memory_collection()`：更新记忆库配置。 * `delete_memory_collection()`：删除记忆库。 * `get_memory_connection_info()`：获取连接信息。 **设计理念**：控制面和数据面解耦 * **控制面**（SDK提供）：管理记忆库的创建、配置和获取连接信息。 * **数据面**（ADK实现）：通过MemoryBase或Mem0协议进行实际的记忆读写。 #### AgentKitKnowledge 知识库服务客户端，管理Agent的向量化知识库。 **主要功能**： * `list_knowledge_bases()`：列举知识库。 * `add_knowledge_base()`：添加知识库。 * `get_knowledge_connection_info()`：获取知识库连接信息。 * `delete_knowledge_base()`：删除知识库。 **使用场景**： * RAG（检索增强生成）应用 * 文档问答系统 * 知识图谱集成 #### AgentKitMCP MCP Gateway客户端，用于管理和路由大量MCP工具。 **主要功能**： * 注册和管理MCP服务。 * 工具聚合和智能路由。 * 降低工具集成复杂度。 #### AgentKitRuntime Runtime管理客户端，用于管理Agent的运行时环境。 **主要功能**： * 创建和管理Runtime实例。 * 查询Runtime状态。 * 配置环境变量和资源。 ### 基础设施模块 #### BaseAgentKitClient 所有客户端的基类，提供统一的配置和HTTP请求能力。 **配置项**： * API端点配置 * 认证凭证管理 * 请求重试和超时 * 日志和监控 #### Context管理使用`contextvars`管理每个请求的上下文信息，包括： * 用户身份 * 会话ID * 请求元数据 * 链路追踪信息 ## 模块依赖关系 ```Plain Text AgentKit SDK │ ├── Runtime Apps (应用框架层) │ ├── AgentkitSimpleApp │ ├── AgentkitMCPApp │ ├── AgentkitA2aApp │ └── AgentkitAgentServerApp │ ├── Platform Clients (服务客户端层) │ ├── AgentkitMemory │ ├── AgentkitKnowledge │ ├── AgentkitMCP │ └── AgentkitRuntime │ └── Infrastructure (基础设施层) ├── BaseAgentkitClient ├── Context └── Telemetry (可观测性) ``` ## 主要特性 ### 装饰器驱动使用Python装饰器简化应用开发，开发者只需关注业务逻辑。 ```Python from agentkit.apps import AgentkitSimpleApp app = AgentkitSimpleApp() @app.entrypoint async def run(payload: dict, headers: dict) -> str: # 业务逻辑 return response ``` ### 框架无关 SDK不限制使用特定的Agent框架，支持： * Volcengine ADK（VeADK） * Google ADK（gadk） * LangChain * 自定义框架 ### 自动化的可观测性内置OpenTelemetry支持，自动收集： * 链路追踪（Tracing） * 性能指标（Metrics） * 日志（Logging） ### 生产就绪提供完整的生产环境支持： * 健康检查端点 * 优雅关闭 * 错误处理 * 请求重试 ### 类型安全 * 完整的Python类型注解，提供： * IDE自动补全 * 类型检查 * 更好的代码可维护性