Parameters

ParameterTypeDefaultDescription
membersList[Union[Agent, Team]]-List of agents or teams that make up this team
modeLiteral["route", "coordinate", "collaborate"]"coordinate"Team operating mode
modelOptional[Model]NoneModel to use for the team
nameOptional[str]NoneName of the team
team_id`Optional[str]NoneTeam UUID (autogenerated if not set)
parent_team_idOptional[str]NoneIf this team is part of a team itself, this is the role of the team
workflow_idOptional[str]NoneThe workflow this team belongs to
roleOptional[str]NoneRole of the team within its parent team
user_idOptional[str]NoneID of the user interacting with this team
session_idOptional[str]NoneSession UUID (autogenerated if not set)
team_session_idOptional[str]NoneIn the case where the team is a member of a team itself
session_nameOptional[str]NoneSession name
session_stateOptional[Dict[str, Any]]NoneSession state (stored in the database to persist across runs)
team_session_stateOptional[Dict[str, Any]]NoneTeam session state (shared between team leaders and team members)
add_state_in_messagesboolFalseIf True, add the session state variables in the user and system messages
descriptionOptional[str]NoneA description of the team that is added to the start of the system message
instructionsOptional[Union[str, List[str], Callable]]NoneList of instructions for the team
expected_outputOptional[str]NoneProvide the expected output from the team
additional_contextOptional[str]NoneAdditional context added to the end of the system message
success_criteriaOptional[str]NoneDefine the success criteria for the team
markdownboolFalseIf markdown=true, add instructions to format the output using markdown
add_datetime_to_instructionsboolFalseIf True, add the current datetime to the instructions to give the team a sense of time
add_location_to_instructionsboolFalseIf True, add the current location to the instructions to give the team a sense of location
add_member_tools_to_system_messageboolTrueIf True, add the tools available to team members to the system message
knowledgeOptional[AgentKnowledge]NoneAdd a knowledge base to the team
knowledge_filtersOptional[Dict[str, Any]]NoneFilters to apply to knowledge base searches
enable_agentic_knowledge_filtersOptional[bool]FalseLet the agent choose the knowledge filters
retrieverOptional[Callable[..., Optional[List[Dict]]]]NoneCustom retrieval function to get references
references_formatLiteral["json", "yaml"]"json"Format of the references
contextOptional[Dict[str, Any]]NoneUser provided context
add_contextboolFalseIf True, add the context to the user prompt
enable_agentic_contextboolFalseIf True, enable the team agent to update the team context and automatically send the team context to the members
share_member_interactionsboolFalseIf True, send all previous member interactions to members
get_member_information_toolboolFalseIf True, add a tool to get information about the team members
search_knowledgeboolTrueAdd a tool to search the knowledge base (aka Agentic RAG)
read_team_historyboolFalseIf True, read the team history
toolsOptional[List[Union[Toolkit, Callable, Function, Dict]]]NoneA list of tools provided to the Model
show_tool_callsboolTrueShow tool calls in Team response
tool_call_limitOptional[int]NoneMaximum number of tool calls allowed
tool_choiceOptional[Union[str, Dict[str, Any]]]NoneControls which (if any) tool is called by the team model
tool_hooksOptional[List[Callable]]NoneA list of hooks to be called before and after the tool call
response_modelOptional[Type[BaseModel]]NoneResponse model for the team response
use_json_modeboolFalseIf response_model is set, sets the response mode of the model
parse_responseboolTrueIf True, parse the response
memoryOptional[Union[TeamMemory, Memory]]NoneMemory for the team
enable_agentic_memoryboolFalseEnable the agent to manage memories of the user
enable_user_memoriesboolFalseIf True, the agent creates/updates user memories at the end of runs
add_memory_referencesOptional[bool]NoneIf True, the agent adds a reference to the user memories in the response
enable_session_summariesboolFalseIf True, the agent creates/updates session summaries at the end of runs
add_session_summary_referencesOptional[bool]NoneIf True, the agent adds a reference to the session summaries in the response
add_history_to_messagesboolFalseIf True, add messages from the chat history to the messages list sent to the Model.
num_history_runsint3Number of historical runs to include in the messages
storageOptional[Storage]NoneStorage for the team
extra_dataOptional[Dict[str, Any]]NoneExtra data stored with this team
reasoningboolFalseEnable reasoning for the team
reasoning_modelOptional[Model]NoneModel to use for reasoning
reasoning_min_stepsint1Minimum number of reasoning steps
reasoning_max_stepsint10Maximum number of reasoning steps
streamOptional[bool]NoneStream the response from the Team
stream_intermediate_stepsboolFalseStream the intermediate steps from the Team
stream_member_eventsboolTrueStream the member events from the Team members
store_eventsboolFalseStore the streaming events on the TeamRunResponse
events_to_skipOptional[List[Union[RunEvent, TeamRunEvent]]]NoneSpecify which event types to skip when storing events on the TeamRunResponse
app_idOptional[str]NoneOptional app ID. Indicates this team is part of an app
debug_modeboolFalseEnable debug logs
show_members_responsesboolFalseEnable member logs - Sets the debug_mode for team and members
monitoringboolFalseLog team information to agno.com for monitoring
telemetryboolTrueLog minimal telemetry for analytics

Functions

FunctionDescription
print_responseRun the team and print the response
runRun the team
aprint_responseRun the team and print the response asynchronously
arunRun the team asynchronously
get_session_summaryGet the session summary for the given session ID and user ID
get_user_memoriesGet the user memories for the given user ID
get_member_informationGet information about the members of the team
get_team_historyGet the team chat history
search_knowledge_baseSearch the knowledge base for information
load_sessionLoad an existing session from the database or create a new one
rename_sessionRename the current session
delete_sessionDelete a session
add_imageAdd an image to the team session
add_videoAdd a video to the team session
add_audioAdd audio to the team session
get_imagesGet all images from the team session
get_videosGet all videos from the team session
get_audioGet all audio from the team session

Team Modes

The team can operate in three different modes:

  1. "route" - Routes tasks to specific team members
  2. "coordinate" - Coordinates between team members (default)
  3. "collaborate" - Enables collaboration between team members

Knowledge Base Integration

The team supports integration with a knowledge base through the following features:

  • knowledge: Add a knowledge base to the team
  • knowledge_filters: Apply filters to knowledge base searches
  • enable_agentic_knowledge_filters: Let the agent choose the knowledge filters
  • retriever: Custom retrieval function for references
  • search_knowledge: Tool to search the knowledge base

Memory and History

The team supports various memory and history features:

  • memory: Team memory storage
  • enable_agentic_memory: Enable agent memory management
  • enable_user_memories: Create/update user memories at the end of runs
  • enable_session_summaries: Create/update session summaries at the end of runs
  • add_history_to_messages: Add messages from the chat history to the messages list sent to the Model.
  • num_history_runs: Number of historical runs to include

Tools and Functions

The team can be equipped with various tools and functions:

  • tools: List of tools provided to the model
  • tool_call_limit: Maximum number of tool calls
  • tool_choice: Control which tool is called
  • tool_hooks: Hooks for tool execution

Reasoning

The team supports reasoning capabilities:

  • reasoning: Enable reasoning
  • reasoning_model: Model for reasoning
  • reasoning_min_steps: Minimum reasoning steps
  • reasoning_max_steps: Maximum reasoning steps