火山引擎代理开发工具包（VeADK）

它是什么

• 一个用于构建在火山引擎大模型平台（ARK）上运行的AI代理的Python库。它捆绑了轻量级运行时、工具集成助手，以及可选的Web UI/Studio组件。

关键能力

• 代理抽象 – veadk.Agent 封装了一个语言模型（例如，托管在火山引擎上的兼容OpenAI的模型），并提供了一个简单的 run(prompt) 异步API。
• 工具扩展 – 内置支持飞书机器人频道、基于数据库的短期记忆、评估工具和CLI。
• AgentKit集成 – 一行工厂函数（create_agentkit_app）生成一个FastAPI应用，暴露健康检查、元数据和兼容Studio的端点（动态工具、网络搜索、知识库、长期记忆等）。
• 基于YAML的配置 – 项目根目录下的 config.yaml 可以指定模型提供商、API端点、凭据和可选工具设置。
• 开发者资源 – Jupyter教程、Google-Colab链接和全面的文档。

快速开始

# 从PyPI安装（核心+可选扩展）
pip install veadk-python[extensions]

from veadk import Agent
import asyncio

agent = Agent()  # 自动读取config.yaml
result = asyncio.run(agent.run("hello!"))
print(result)

典型工作流程

1. 创建一个包含你的火山引擎ARK API密钥和模型名称的 config.yaml。
2. 在你的代码中实例化 Agent（或一个命名的子代理）。
3. 可选地，用 create_agentkit_app 包装它，以暴露一个Studio可以管理的FastAPI服务器（元数据、工具路由、反馈收集）。
4. 部署服务器或在本地运行；使用提供的飞书频道扩展将代理连接到飞书机器人。

可扩展性

• 数据库扩展 – uv sync --extra database 添加持久化短期记忆。
• 评估扩展 – 添加用于反馈的评估集处理。
• CLI扩展 – 提供用于运行代理和管理会话的命令行工具。

社区与支持

• 在Apache 2.0下开源。
• 文档站点：https://volcengine.github.io/veadk-python/
• 讨论组（仓库中的二维码）用于实时帮助。
• 强制执行安全策略和CI测试；贡献需要通过 pytest。

谁应该使用它

• 希望在火山引擎基础设施上快速原型或交付LLM驱动的代理的开发者。
• 需要内置集成（飞书、知识库、记忆存储）而无需编写样板网络代码的团队。
• 使用火山引擎AgentKit平台并希望有一个与Studio UI对齐的Python SDK的用户。