Agent Stack

开放的基础设施，可在几分钟内将AI智能体转化为可运行的服务。

核心功能 • 快速入门 • 参考智能体 •

构建智能体 → 将其作为服务运行 → 在您的应用中调用它们。

---

Agent Stack 是一个开放的基础设施，可在几分钟内将 AI 智能体转化为可运行的服务。您可以在本地或自己的环境中运行智能体，通过 HTTP 将它们集成到您的应用程序中，并在无需从头构建部署基础设施的情况下推出由智能体驱动的功能。Agent Stack 基于 Agent2Agent (A2A) 协议 构建，并由 Linux 基金会 托管，确保您不会被锁定在某个专有供应商的生态系统中。

如果您正在构建由智能体驱动的功能，或者希望让您的智能体脱离原型阶段投入实际使用，Agent Stack 可以通过提供 LLM 路由、向量存储、身份验证、文件处理、部署工具等开箱即用的功能，为您从代码到部署就绪的服务提供一条快速通道。

🎯 将智能体作为服务运行	通过 HTTP 公开智能体，供实际应用调用，并像其他后端服务一样进行访问
🔄 快速的本地开发循环	在本地启动智能体并快速迭代
🔧 无需重写智能体	包装现有智能体并按原样运行
🚀 部署就绪的架构	同样的智能体可以从本地环境迁移到部署环境

---

核心能力

组件	包含内容
智能体运行时	- 自托管服务器，用于在生产环境中运行智能体
LLM 和 AI 服务	- 支持 15+ 提供商（Anthropic、OpenAI、watsonx.ai、Ollama 等）的 LLM 服务 - 用于 RAG 和语义搜索的嵌入和向量检索
智能体部署与管理	- 用于部署、更新和管理智能体的 CLI
存储与文档	- 兼容 S3 的文件存储，用于上传和下载 - 通过 Docling 进行文档文本提取
接口与工具	- 开箱即用的 Web UI，用于测试和分享智能体 - 客户端 SDK，用于构建自定义 UI 和应用程序
集成	- 通过 MCP 协议实现外部集成（API、Slack、Google Drive 等），支持 OAuth
安全	- 用于 API 密钥和凭据的秘密管理 - 支持 OAuth，确保外部集成的安全性
Agent Stack 部署	- 适用于 Kubernetes 的 Helm Chart，支持自定义存储、数据库和身份验证
框架互操作性	- 可使用 LangGraph、CrewAI 或您自己的框架构建智能体 - 所有智能体都会自动暴露为 A2A 兼容的智能体，以实现互操作性 - SDK 处理运行时服务请求和智能体之间的通信

注意: Agent Stack 提供了功能齐全的默认配置，以便您快速上手。每个组件都是模块化的，可以替换以集成到您组织现有的服务、提供商和基础设施中。

快速入门

安装

sh -c "$(curl -LsSf https://agentstack.beeai.dev/install.sh)"

[!TIP] 这条单行脚本适用于 Linux 和 macOS。如需手动设置或体验 Windows 支持，请参阅 快速入门指南。

使用

agentstack ui                           # 启动 Web 界面
agentstack list                         # 查看可用的智能体
agentstack run chat "Hi, who are you"   # 向聊天智能体发送消息
agentstack run chat                     # 尝试交互模式
agentstack info chat                    # 查看智能体详情
agentstack --help                       # 查看所有选项

构建您的第一个智能体

git clone https://github.com/i-am-bee/agentstack-starter my-agent
cd my-agent
uv run server               # 启动您的智能体

然后在另一个终端：

agentstack run example_agent "Alice"  # 测试您的智能体

您应该会看到：“Ciao Alice!” 🎉

[!TIP] 请查看 构建智能体 ，获取创建您的第一个智能体的完整分步指南。

---

参考代理

展示 Agent Stack 核心功能的参考实现。

• Agent Stack 展示 - 全功能聊天助手，演示了 RequirementAgent 的条件化工具使用、网络搜索（DuckDuckGo）、高级推理（ThinkTool）、文件处理（PDF/CSV/JSON）、流式传输、UI 功能切换、轨迹日志记录以及引用提取。
• Serper 搜索代理 - 网络搜索代理，展示了运行时密钥管理（Secrets Extension）、自定义工具创建（SerperSearchTool）、查询词自动提取以及带引用的结构化结果。
• GitHub 问题编写器 - 单轮工作流，利用 Form Extension 进行多字段输入，结合 ThinkTool 实现 AI 增强的问题草拟，并进行 Markdown 格式化。
• 漏洞代理 - 单轮工作流，扫描 GitHub 仓库中的 Python 依赖项以查找已知漏洞，撰写修复问题并代表用户在 GitHub 仓库中提交。使用表单扩展、UI 功能、密钥管理、MCP 工具、轨迹日志记录和引用格式化。
• 聊天代理 - 多轮对话代理，采用 RequirementAgent、ActTool 进行推理序列处理，以及 ClarificationTool 处理模糊查询。集成 DuckDuckGo、Wikipedia、OpenMeteo 和文件工具，支持无约束内存、流式传输、引用提取及 OpenTelemetry 监控。
• 表单代理 - 单轮表单交互，使用 Form Extension 支持多种字段类型、可定制布局、文件上传、验证及结构化输出。
• RAG 代理 - 检索增强型生成代理，支持 12 种以上文件格式、动态向量存储、语义搜索（VectorSearchTool）、文档摘要（FileReaderTool）、智能工具选择以及包含文档 URL 的引用跟踪。
• 画布代理 - 多轮工件编辑，可选择并编辑特定部分。
• OAuth 代理 - OAuth Extension 示例，集成 MCP、基于浏览器的授权、安全令牌管理，并可访问 Stripe 的 MCP 服务器。
• 动态表单请求代理 - 多步骤表单工作流，同时展示静态与动态表单生成，代理会在对话过程中根据条件请求额外输入。
• 航班搜索与可视化代理 - 该代理通过 Kiwi.com 的 MCP API 查询航班结果，借助 Form Extension 请求缺失参数，并可选地使用地理空间辅助工具生成 PNG 或 HTML 路线可视化图。它使用 RequirementAgent 协调工具调用（数据验证和可视化），并以流式方式返回最终答案，附带生成的文件和引用。
• 医疗健康代理 - 专注于医疗健康的代理，能够发现并调用由 Agent Stack 管理的其他代理，具备多轮工作流、上下文管理、轨迹追踪和 UI 组件。

---

文档

访问 agentstack.beeai.dev 获取完整文档。

社区

Agent Stack 社区活跃于 GitHub Discussions，您可以在那里提问、提出想法并分享您的项目。

如需与其他社区成员交流，欢迎加入 Agent Stack 的 Discord 服务器。

请注意，我们的 行为准则 适用于所有 Agent Stack 社区渠道。我们强烈建议您阅读并遵守该准则。

维护者

有关维护者的信息，请参阅 MAINTAINERS.md。

贡献

我们始终欢迎并非常感谢对 Agent Stack 的贡献。在参与贡献之前，请先查阅我们的 贡献指南，以确保顺利体验。

特别感谢各位贡献者帮助我们不断改进 Agent Stack。

致谢

Agent Stack 建立在多个代理与协议生态系统中开创性项目所奠定的基础之上：

• Agent2Agent (A2A) 协议 - 开放标准，实现了跨框架的代理间通信
• 模型上下文协议 - 推动了 AI 模型与上下文交互的方式进步

我们感谢这些社区为推动代理基础设施与互操作性的进步所做出的贡献。

---

本项目由 BeeAI 项目的贡献者开发，是 Linux 基金会人工智能与数据计划 的一部分。其开发遵循开放、协作和社区驱动的原则。

AgentStack 快速上手指南

AgentStack 是一个开源基础设施，旨在帮助开发者在几分钟内将 AI 智能体（Agents）转化为可运行的服务。它支持本地开发、HTTP 调用以及生产环境部署，基于 A2A 协议构建，由 Linux Foundation 托管，确保无厂商锁定。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：推荐 Linux 或 macOS。
  • 注：Windows 支持处于实验阶段，建议通过 WSL2 运行。
• 网络环境：需要能够访问 GitHub 和外部 AI 模型提供商（如 OpenAI, Anthropic 等）。
• 依赖工具：
  • curl：用于下载安装脚本。
  • git：用于克隆示例项目。
  • uv 或 python：用于运行智能体代码（示例中使用 uv）。

提示：国内开发者若遇到安装脚本下载缓慢，可尝试配置终端代理或使用国内镜像源加速 pip/uv 依赖安装。

安装步骤

AgentStack 提供了一键安装脚本，适用于 Linux 和 macOS 系统。

1. 执行安装命令

在终端中运行以下命令：

sh -c "$(curl -LsSf https://agentstack.beeai.dev/install.sh)"

2. 验证安装

安装完成后，可以通过以下命令查看帮助信息以确认安装成功：

agentstack --help

基本使用

安装完成后，您可以立即启动内置的 Web 界面或与预置的智能体进行交互。

1. 启动 Web 界面

运行以下命令打开图形化测试界面，方便调试和分享智能体：

agentstack ui

2. 命令行交互

您可以直接在终端向智能体发送消息。例如，向内置的 chat 智能体发送问候：

agentstack run chat "Hi, who are you"

或者进入交互式对话模式：

agentstack run chat

3. 查看可用智能体

列出当前环境中所有可用的智能体：

agentstack list

4. 构建并运行您的第一个智能体

想要运行自定义智能体？请按照以下步骤操作：

第一步：克隆示例项目

git clone https://github.com/i-am-bee/agentstack-starter my-agent
cd my-agent

第二步：启动智能体服务 在新终端中运行：

uv run server

第三步：测试智能体 在另一个终端中调用该智能体：

agentstack run example_agent "Alice"

如果配置正确，您将看到输出："Ciao Alice!" 🎉

---

更多详细功能（如 RAG、OAuth 集成、多智能体协作等），请参考官方文档：agentstack.beeai.dev