InvokeCrewAIAutomationTool
The InvokeCrewAIAutomationTool
provides CrewAI Platform API integration with external crew services. This tool allows you to invoke and interact with CrewAI Platform automations from within your CrewAI agents, enabling seamless integration between different crew workflows.
Installation
Requirements
- CrewAI Platform API access
- Valid bearer token for authentication
- Network access to CrewAI Platform automation endpoints
Usage
Here’s how to use the tool with a CrewAI agent:Tool Arguments
Argument | Type | Required | Default | Description |
---|---|---|---|---|
crew_api_url | str | Yes | None | Base URL of the CrewAI Platform automation API |
crew_bearer_token | str | Yes | None | Bearer token for API authentication |
crew_name | str | Yes | None | Name of the crew automation |
crew_description | str | Yes | None | Description of what the crew automation does |
max_polling_time | int | No | 600 | Maximum time in seconds to wait for task completion |
crew_inputs | dict | No | None | Dictionary defining custom input schema fields |
Environment Variables
Advanced Usage
Custom Input Schema with Dynamic Parameters
Multi-Stage Automation Workflow
Use Cases
Distributed Crew Orchestration
- Coordinate multiple specialized crew automations to handle complex, multi-stage workflows
- Enable seamless handoffs between different automation services for comprehensive task execution
- Scale processing by distributing workloads across multiple CrewAI Platform automations
Cross-Platform Integration
- Bridge CrewAI agents with CrewAI Platform automations for hybrid local-cloud workflows
- Leverage specialized automations while maintaining local control and orchestration
- Enable secure collaboration between local agents and cloud-based automation services
Enterprise Automation Pipelines
- Create enterprise-grade automation pipelines that combine local intelligence with cloud processing power
- Implement complex business workflows that span multiple automation services
- Enable scalable, repeatable processes for data analysis, reporting, and decision-making
Dynamic Workflow Composition
- Dynamically compose workflows by chaining different automation services based on task requirements
- Enable adaptive processing where the choice of automation depends on data characteristics or business rules
- Create flexible, reusable automation components that can be combined in various ways
Specialized Domain Processing
- Access domain-specific automations (financial analysis, legal research, technical documentation) from general-purpose agents
- Leverage pre-built, specialized crew automations without rebuilding complex domain logic
- Enable agents to access expert-level capabilities through targeted automation services
Custom Input Schema
When definingcrew_inputs
, use Pydantic Field objects to specify the input parameters:
Error Handling
The tool provides comprehensive error handling for common scenarios:- API Connection Errors: Network connectivity issues with CrewAI Platform
- Authentication Errors: Invalid or expired bearer tokens
- Timeout Errors: Tasks that exceed the maximum polling time
- Task Failures: Crew automations that fail during execution
- Input Validation Errors: Invalid parameters passed to automation endpoints
API Endpoints
The tool interacts with two main API endpoints:POST {crew_api_url}/kickoff
: Starts a new crew automation taskGET {crew_api_url}/status/{crew_id}
: Checks the status of a running task
Notes
- The tool automatically polls the status endpoint every second until completion or timeout
- Successful tasks return the result directly, while failed tasks return error information
- Bearer tokens should be kept secure and not hardcoded in production environments
- Consider using environment variables for sensitive configuration like bearer tokens
- Custom input schemas must be compatible with the target crew automation’s expected parameters