🚀 AskTheApi 团队构建器

AskTheApi 团队构建器是一个高级 Python 库，可用于构建和管理自主代理网络，以解决复杂任务。它与基于 OpenAPI 标准定义的 API 无缝协作，提供干净、类型安全的接口，能让您以最少的样板代码编排多代理工作流。

🚀 快速开始

以下是一个简单的示例，展示了如何使用 asktheapi-team-builder 创建和管理一个代理团队：

from asktheapi_team_builder import TeamBuilder

# 初始化团队构建器
team_builder = TeamBuilder()

# 添加代理到团队
team_builder.add_agent("Alice", "您好！我是Alice，您的助手。")
team_builder.add_agent("Bob", "您好！我是Bob，您的助手。")

# 启动团队
await team_builder.start()

功能概述

1. 添加代理：使用 add_agent 方法将代理添加到团队中。
2. 启动团队：调用 start 方法开始团队的协作流程。
3. 自定义配置：通过参数传递或后端设置调整代理行为。

✨ 主要特性

• 🚀 快速创建代理网络：轻松根据 OpenAPI 规范构建自定义工具和功能的代理。
• 🤝 团队协作：轻松定义代理团队，并由内置计划代理自动处理协调。
• 📡 流式交互：实时流代理通信，实现更动态和响应式的流程。
• 🔧 内置 HTTP 客户端：简化工具实现，集成 HTTP 客户端直接调用外部 API。
• ✨ 使用 Pydantic 的类型安全：确保代码的可靠性和可维护性。
• 📦 支持自定义配置：灵活调整代理行为以适应不同需求。

📦 安装指南

pip install asktheapi-team-builder

💻 使用示例

基础用法

from asktheapi_team_builder import TeamBuilder

# 初始化团队构建器
team_builder = TeamBuilder()

# 添加代理到团队
team_builder.add_agent("Alice", "您好！我是Alice，您的助手。")
team_builder.add_agent("Bob", "您好！我是Bob，您的助手。")

# 启动团队
await team_builder.start()

高级用法

自定义头和配置

您可以自定义 HTTP 请求中的头信息，以适应不同的 API 要求：

from asktheapi_team_builder import TeamBuilder

# 初始化团队构建器并设置自定义头
team_builder = TeamBuilder(headers={"Authorization": "Bearer your-token"})

# 添加代理到团队
team_builder.add_agent("Charlie", "您好！我是Charlie，您的助手。")

# 启动团队
await team_builder.start()

MCP 支持

asktheapi-team-builder 提供对 Model Control Protocol (MCP) 的支持，方便您通过 OpenAPI 规范自动创建和管理工具：

from asktheapi_team_builder.mcp import McpService

# 初始化 MCP 服务并启动从 OpenAPI 规范
mcp_service = McpService()
await mcp_service.start_from_spec(
    url_spec="https://api.example.com/openapi.json",
    headers={"Authorization": "Bearer your-token"}
)

📚 详细文档

贡献指南

欢迎贡献！请随意提交 Pull Request。对于重大更改，请先打开问题讨论您想更改的内容。

1. 叉仓库
2. 创建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m '添加一些很棒的功能')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开 Pull Request

开发设置

# 克隆仓库
git clone https://github.com/alexalbala/asktheapi-team-builder.git
cd asktheapi-team-builder

# 安装依赖项
pip install -e ".[dev]"

# 运行测试
pytest

📄 许可证

此项目根据 MIT License 许可。有关详细信息，请参阅 LICENSE 文件。

致谢

• 基于 Microsoft 的 AutoGen 构建
• 受到更高层次接口的代理团队管理需求的启发