AgentKit
AgentKit
文档指南
请输入
- 文档首页
AgentKitAgentKit开发者指南SDK参考SDK概述
复制全文
下载 pdfSDK概述
文档反馈
问问助手本文对AgentKit SDK进行简要介绍，包含其核心架构设计、模块依赖关系及主要特性等。
SDK介绍
AgentKit SDK是一个Python开发工具包，用于快速构建符合AgentKit标准的Agent应用。SDK提供了一套简洁的装饰器和客户端接口（AgentKit API概览），帮助开发者专注于Agent业务逻辑的实现及资源的创建和管理。
SDK地址
编程语言 | Github地址 | 指导文档 |
Python | 安装指导 |
核心架构
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
- 请求元数据
- 链路追踪信息
模块依赖关系
主要特性
装饰器驱动
使用Python装饰器简化应用开发，开发者只需关注业务逻辑。
框架无关
SDK不限制使用特定的Agent框架，支持：
- Volcengine ADK（VeADK）
- Google ADK（gadk）
- LangChain
- 自定义框架
自动化的可观测性
内置OpenTelemetry支持，自动收集：
- 链路追踪（Tracing）
- 性能指标（Metrics）
- 日志（Logging）
生产就绪
提供完整的生产环境支持：
- 健康检查端点
- 优雅关闭
- 错误处理
- 请求重试
类型安全
- 完整的Python类型注解，提供：
- IDE自动补全
- 类型检查
- 更好的代码可维护性
最近更新时间：2026.01.29 14:26:01
这个页面对您有帮助吗？
有用
有用
无用
无用