Learn how to use Agent Repositories to share and reuse your agents across teams and projects
Agent Repositories allow enterprise users to store, share, and reuse agent definitions across teams and projects. This feature enables organizations to maintain a centralized library of standardized agents, promoting consistency and reducing duplication of effort.
You can load agents from repositories in your code using the from_repository parameter:
Copy
Ask AI
from crewai import Agent# Create an agent by loading it from a repository# The agent is loaded with all its predefined configurationsresearcher = Agent( from_repository="market-research-agent")
You can override specific settings from the repository by providing them in the configuration:
Copy
Ask AI
researcher = Agent( from_repository="market-research-agent", goal="Research the latest trends in AI development", # Override the repository goal verbose=True # Add a setting not in the repository)
from crewai import Crew, Agent, Task# Load agents from repositoriesresearcher = Agent( from_repository="market-research-agent")writer = Agent( from_repository="content-writer-agent")# Create tasksresearch_task = Task( description="Research the latest trends in AI", agent=researcher)writing_task = Task( description="Write a comprehensive report based on the research", agent=writer)# Create the crewcrew = Crew( agents=[researcher, writer], tasks=[research_task, writing_task], verbose=True)# Run the crewresult = crew.kickoff()
You can also use repository agents directly with the kickoff() method for simpler interactions:
Copy
Ask AI
from crewai import Agentfrom pydantic import BaseModelfrom typing import List# Define a structured output formatclass MarketAnalysis(BaseModel): key_trends: List[str] opportunities: List[str] recommendation: str# Load an agent from repositoryanalyst = Agent( from_repository="market-analyst-agent", verbose=True)# Get a free-form responseresult = analyst.kickoff("Analyze the AI market in 2025")print(result.raw) # Access the raw response# Get structured outputstructured_result = analyst.kickoff( "Provide a structured analysis of the AI market in 2025", response_format=MarketAnalysis)# Access structured dataprint(f"Key Trends: {structured_result.pydantic.key_trends}")print(f"Recommendation: {structured_result.pydantic.recommendation}")
To switch between organizations or see your current organization, use the CrewAI CLI:
Copy
Ask AI
# View current organizationcrewai org current# Switch to a different organizationcrewai org switch <org_id># List all available organizationscrewai org list
When loading agents from repositories, you must be authenticated and switched to the correct organization. If you receive errors, check your authentication status and organization settings using the CLI commands above.