Asktheapi Team Builder

🚀 AskTheApi Team Builder

An advanced Python library for building and managing autonomous agent networks to tackle complex tasks. It seamlessly integrates with APIs defined by the OpenAPI standard, offering clean and type-safe interfaces to create, configure, and run agent teams, enabling you to orchestrate multi-agent workflows with minimal boilerplate code.

🚀 Quick Start

Here is a simple example demonstrating how to use asktheapi-team-builder to create and manage an agent team:

Example Code

from asktheapi_team_builder import TeamBuilder

# Initialize the team builder
team_builder = TeamBuilder()

# Add agents to the team
team_builder.add_agent("Alice", "Hello! I'm Alice, your assistant.")
team_builder.add_agent("Bob", "Hello! I'm Bob, your assistant.")

# Start the team
await team_builder.start()

Function Overview

1. Add Agents: Use the add_agent method to add agents to the team.
2. Start the Team: Call the start method to initiate the team's collaboration process.
3. Custom Configuration: Adjust agent behavior through parameter passing or backend settings.

✨ Features

• 🚀 Rapid Agent Network Creation: Effortlessly build agents with custom tools and functions based on OpenAPI specifications.
• 🤝 Team Collaboration: Easily define agent teams, and let the built-in planning agent handle coordination automatically.
• 📡 Streamed Interaction: Stream agent communication in real-time for more dynamic and responsive processes.
• 🔧 Built-in HTTP Client: Simplify tool implementation by integrating an HTTP client to directly call external APIs.
• ✨ Type Safety with Pydantic: Ensure code reliability and maintainability.
• 📦 Support for Custom Configuration: Flexibly adjust agent behavior to meet different requirements.

📦 Installation

pip install asktheapi-team-builder

💻 Usage Examples

Basic Usage

The above quick start example shows the basic usage of creating and managing an agent team.

Advanced Usage

Custom Headers and Configuration

You can customize the headers in HTTP requests to meet different API requirements:

from asktheapi_team_builder import TeamBuilder

# Initialize the team builder and set custom headers
team_builder = TeamBuilder(headers={"Authorization": "Bearer your-token"})

# Add an agent to the team
team_builder.add_agent("Charlie", "Hello! I'm Charlie, your assistant.")

# Start the team
await team_builder.start()

MCP Support

asktheapi-team-builder provides support for the Model Control Protocol (MCP), allowing you to automatically create and manage tools through OpenAPI specifications:

from asktheapi_team_builder.mcp import McpService

# Initialize the MCP service and start from the OpenAPI specification
mcp_service = McpService()
await mcp_service.start_from_spec(
    url_spec="https://api.example.com/openapi.json",
    headers={"Authorization": "Bearer your-token"}
)

🤝 Contribution Guidelines

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

1. Fork the repository.
2. Create a feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes (git commit -m 'Add some amazing features').
4. Push to the branch (git push origin feature/amazing-feature).
5. Open a Pull Request.

🔧 Development Setup

# Clone the repository
git clone https://github.com/alexalbala/asktheapi-team-builder.git
cd asktheapi-team-builder

# Install dependencies
pip install -e ".[dev]"

# Run tests
pytest

📄 License

This project is licensed under the MIT License. For more details, please refer to the LICENSE file.

🙏 Acknowledgments

• Built on top of Microsoft's AutoGen.
• Inspired by the need for a higher-level interface for agent team management.