团队

参数

参数	类型	默认值	描述
members	List[Union[Agent, Team]]	-	构成此团队的代理或团队列表
mode	Literal["route", "coordinate", "collaborate"]	"coordinate"	团队运行模式
model	Optional[Model]	None	要使用的模型
name	Optional[str]	None	团队名称
team_id	Optional[str]	None	团队 UUID（如果未设置则自动生成）
parent_team_id	Optional[str]	None	如果此团队本身是某个团队的一部分，则这是该团队的角色
workflow_id	Optional[str]	None	此团队所属的工作流
role	Optional[str]	None	团队在其父团队中的角色
user_id	Optional[str]	None	与此团队交互的用户的 ID
session_id	Optional[str]	None	会话 UUID（如果未设置则自动生成）
team_session_id	Optional[str]	None	当团队本身是另一个团队的成员时
session_name	Optional[str]	None	会话名称
session_state	Optional[Dict[str, Any]]	None	会话状态（存储在数据库中以在运行之间持久化）
team_session_state	Optional[Dict[str, Any]]	None	团队会话状态（在团队领导者和团队成员之间共享）
add_state_in_messages	bool	False	如果为 True，则将会话状态变量添加到用户和系统消息中
description	Optional[str]	None	添加到系统消息开头的团队描述
instructions	Optional[Union[str, List[str], Callable]]	None	团队的指令列表
expected_output	Optional[str]	None	提供团队的预期输出
additional_context	Optional[str]	None	添加到系统消息末尾的附加上下文
success_criteria	Optional[str]	None	定义团队的成功标准
markdown	bool	False	如果 markdown=true，则添加指令以使用 markdown 格式化输出
add_datetime_to_instructions	bool	False	如果为 True，则将当前日期时间添加到指令中，让团队了解时间
add_location_to_instructions	bool	False	如果为 True，则将当前位置添加到指令中，让团队了解位置
add_member_tools_to_system_message	bool	True	如果为 True，则将团队成员可用的工具添加到系统消息中
knowledge	Optional[AgentKnowledge]	None	向团队添加知识库
knowledge_filters	Optional[Dict[str, Any]]	None	要应用于知识库搜索的过滤器
enable_agentic_knowledge_filters	Optional[bool]	False	让代理选择知识过滤器
retriever	Optional[Callable[..., Optional[List[Dict]]]]	None	用于获取引用的自定义检索函数
references_format	Literal["json", "yaml"]	"json"	引用的格式
context	Optional[Dict[str, Any]]	None	用户提供的上下文
add_context	bool	False	如果为 True，则将上下文添加到用户提示中
enable_agentic_context	bool	False	如果为 True，使团队代理能够更新团队上下文并自动将团队上下文发送给成员
share_member_interactions	bool	False	如果为 True，则将所有先前的成员交互发送给成员
get_member_information_tool	bool	False	如果为 True，则添加一个用于获取团队成员信息的工具
search_knowledge	bool	True	添加一个搜索知识库的工具（即 Agentic RAG）
read_team_history	bool	False	如果为 True，则读取团队历史记录
tools	Optional[List[Union[Toolkit, Callable, Function, Dict]]]	None	提供给模型的工具列表
show_tool_calls	bool	True	在团队响应中显示工具调用
tool_call_limit	Optional[int]	None	允许的最大工具调用次数
tool_choice	Optional[Union[str, Dict[str, Any]]]	None	控制团队模型调用哪个（如果有）工具
tool_hooks	Optional[List[Callable]]	None	在工具调用之前和之后调用的钩子列表
response_model	Optional[Type[BaseModel]]	None	团队响应的响应模型
parser_model	Optional[Model]	None	用于解析响应的模型
parser_model_prompt	Optional[str]	None	用于解析响应的提示
use_json_mode	bool	False	如果设置了 response_model，则设置模型的响应模式
parse_response	bool	True	如果为 True，则解析响应
memory	Optional[Union[TeamMemory, Memory]]	None	团队记忆存储
enable_agentic_memory	bool	False	启用代理来管理用户记忆
enable_user_memories	bool	False	如果为 True，代理将在运行结束时创建/更新用户记忆
add_memory_references	Optional[bool]	None	如果为 True，代理会在响应中添加对用户记忆的引用
enable_session_summaries	bool	False	如果为 True，代理将在运行结束时创建/更新会话摘要
add_session_summary_references	Optional[bool]	None	如果为 True，代理会在响应中添加对会话摘要的引用
add_history_to_messages	bool	False	如果为 True，则将聊天历史记录中的消息添加到发送给模型的消息列表中。
num_history_runs	int	3	包含在消息中的历史运行次数
storage	Optional[Storage]	None	团队存储
extra_data	Optional[Dict[str, Any]]	None	与此团队一起存储的额外数据
reasoning	bool	False	启用团队推理
reasoning_model	Optional[Model]	None	用于推理的模型
reasoning_min_steps	int	1	最少推理步数
reasoning_max_steps	int	10	最多推理步数
stream	Optional[bool]	None	从团队流式传输响应
stream_intermediate_steps	bool	False	流式传输团队的中间步骤
stream_member_events	bool	True	流式传输团队成员的事件
store_events	bool	False	将流式事件存储在 TeamRunResponse 上
events_to_skip	Optional[List[Union[RunEvent, TeamRunEvent]]]	None	指定在 TeamRunResponse 上存储事件时要跳过的事件类型
app_id	Optional[str]	None	可选的应用 ID。指示此团队是应用的一部分
debug_mode	bool	False	启用调试日志
show_members_responses	bool	False	启用成员日志 - 为团队和成员设置 debug_mode
monitoring	bool	False	将团队信息记录到 agno.com 以进行监控
telemetry	bool	True	为分析记录最小遥测数据

函数

函数	描述
print_response	运行团队并打印响应
run	运行团队
aprint_response	异步运行团队并打印响应
arun	异步运行团队
get_session_summary	获取给定会话 ID 和用户 ID 的会话摘要
get_user_memories	获取给定用户 ID 的用户记忆
load_session	从数据库加载现有会话或创建新会话
rename_session	重命名当前会话
delete_session	删除会话
get_images	获取团队会话中的所有图片
get_videos	获取团队会话中的所有视频
get_audio	获取团队会话中的所有音频
add_tool	向团队添加工具
set_tools	替换团队的工具

团队模式

团队可以以三种不同的模式运行：

1. "route" - 将任务路由到特定团队成员
2. "coordinate" - 在团队成员之间进行协调（默认）
3. "collaborate" - 启用团队成员之间的协作

知识库集成

团队通过以下功能支持与知识库的集成：

• knowledge: 向团队添加知识库
• knowledge_filters: 应用过滤器到知识库搜索
• enable_agentic_knowledge_filters: 让代理选择知识过滤器
• retriever: 用于引用的自定义检索函数
• search_knowledge: 用于搜索知识库的工具

记忆和历史记录

团队支持各种记忆和历史记录功能：

• memory: 团队记忆存储
• enable_agentic_memory: 启用代理记忆管理
• enable_user_memories: 在运行结束时创建/更新用户记忆
• enable_session_summaries: 在运行结束时创建/更新会话摘要
• add_history_to_messages: 将聊天历史记录中的消息添加到发送给模型的消息列表中。
• num_history_runs: 包含在消息中的历史运行次数

工具和函数

团队可以配备各种工具和函数：

• tools: 提供给模型的工具列表
• tool_call_limit: 最大工具调用数
• tool_choice: 控制调用哪个工具
• tool_hooks: 工具执行的钩子

推理

团队支持推理能力：

• reasoning: 启用推理
• reasoning_model: 推理模型
• reasoning_min_steps: 最少推理步数
• reasoning_max_steps: 最多推理步数