AgentKit 代码工坊

欢迎来到 AgentKit 代码工坊（Samples）仓库！

AgentKit 是火山引擎推出的企业级 AI Agent 开发平台，为开发者提供完整的 Agent 构建、部署和运维解决方案。平台通过标准化的开发工具链和云原生基础设施，显著降低复杂智能体应用的开发部署门槛。

本代码库包含了一系列示例和教程，帮助您理解、实现和集成 AgentKit 的各项功能到您的应用中。

➤ 项目结构

AgentKit 代码工坊为让您快速上手 AgentKit 平台，提供了不同入门等级的示例和教程：

• 基础教程：包含了简单的 Agent 示例，能够帮助您快速理解 AgentKit 的基本概念和使用方法
• 使用案例：针对有一定经验的开发者，提供了较为复杂的 Agent 实现和定制化示例

➤ 前置准备

环境要求	说明
Python 3.10+	确保您的开发环境中安装了 Python 3.10 或更高版本
veadk-python	您需要安装 veadk-python 来执行代码
agentkit-sdk-python	您需要安装 agentkit-sdk-python 来与 AgentKit 平台进行交互
Docker（可选）	用于本地容器构建

➤ 样例列表

名称	难度	描述
hello_world		入门级对话智能体，展示如何创建一个具备短期记忆能力的基础 AI Agent
multi_agents		多智能体协作示例，展示如何通过层级结构和专业分工实现复杂任务的智能化处理
image_video_tools		图片与视频生成智能体，展示多种 VeADK 内置工具能力
mcp_simple		MCP 集成示例，通过 MCP 协议实现 Agent 调用火山引擎 TOS 对象存储服务
vikingdb_agent		基于火山引擎 VeADK 和 VikingDB 构建的 RAG（检索增强生成）示例，展示如何通过向量检索实现专业文档知识库的智能问答
vikingmem_agent		基于火山引擎 VeADK 和 VikingDB 构建的记忆管理示例，展示如何实现智能体的短期记忆和长期记忆功能
a2a_simple		分布式多 Agents 示例，展示如何实现智能体之间的通信和协作
agent_callbacks		Agent 运行时生命周期回调示例，展示 Agent 生命周期各阶段的回调函数和护栏功能
旅行规划助手		结合 Web 搜索工具和专业领域知识，自动规划完整的旅行行程
餐厅智能点餐助手		通过点餐智能体，实现复杂业务流程、异步工具调用、上下文管理和自定义插件等高级特性
实时语音聊天助手		实时语音聊天助手，它包含了Python服务端和用于用户交互的Web客户端
AI 编程助手		AI 编程助手，帮助开发者编写和优化代码
客户服务智能体		提供自动的售后咨询和售前导购
视频生成智能体		结合多种工具实现视频内容创作
门店巡检智能体		基于多 Agents 协作的智能门店巡检系统
数据分析智能体		基于 LanceDB 构建的数据分析智能体
电商营销视频生成		基于A2A构建的多智能体电商营销视频生成示例，展示如何利用A2A以及图片、视频生成工具进行智能视频内容创作
运行skills的智能体		基于 AgentKit & VeADK & sandbox 构建可以运行 skills 的智能体
混合云企业智能客服		展示混合云部署、知识、记忆、工具、安全、可观测与多 Agent 协同的完整故事线

每个用例都包含完整的实现，并详细说明如何结合 AgentKit 组件构建应用。

➤ Agentic Frameworks 适配

AgentKit Runtime 原生支持主流智能体框架，已兼容 LangChain、LangGraph、Strands、Google ADK，以及基于 Bedrock AgentCore Runtime 构建的项目。无需重写现有业务逻辑，只需通过 agentkit migrate 生成 AgentKit Runtime 入口，即可完成运行与部署。

对于尚未适配、项目结构不固定的 Python 应用，以及低代码平台生成的 Workflow 项目，也可结合 AgentKit Migration命令与 AgentKit Codex Sandbox的能力，完成自动化迁移，并将您的项目转换为可部署的veadk项目。 查看示例：python/03-integrations/migration。

➤ 贡献

欢迎您提交您的 Agent 到本仓库！详细的贡献指南请参考 CONTRIBUTING.md。

➤ 问题反馈

• 文档: 查看 AgentKit 官方文档
• 问题: 在 GitHub Issues 中报告问题

➤ 相关资源

• AgentKit 官方网站
• AgentKit SDK/CLI文档
• VeADK 官方文档

➤ 许可证

本项目采用 Apache 2.0 许可证 开源。

---

Happy AgentKit!