Asktheapi Team Builder

🚀 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 構建
• 受到更高層次接口的代理團隊管理需求的啟發