参数

参数类型默认值描述
membersList[Union[Agent, Team]]-构成此团队的代理或团队列表
modeLiteral["route", "coordinate", "collaborate"]"coordinate"团队运行模式
modelOptional[Model]None要使用的模型
nameOptional[str]None团队名称
team_idOptional[str]None团队 UUID(如果未设置则自动生成)
parent_team_idOptional[str]None如果此团队本身是某个团队的一部分,则这是该团队的角色
workflow_idOptional[str]None此团队所属的工作流
roleOptional[str]None团队在其父团队中的角色
user_idOptional[str]None与此团队交互的用户的 ID
session_idOptional[str]None会话 UUID(如果未设置则自动生成)
team_session_idOptional[str]None当团队本身是另一个团队的成员时
session_nameOptional[str]None会话名称
session_stateOptional[Dict[str, Any]]None会话状态(存储在数据库中以在运行之间持久化)
team_session_stateOptional[Dict[str, Any]]None团队会话状态(在团队领导者和团队成员之间共享)
add_state_in_messagesboolFalse如果为 True,则将会话状态变量添加到用户和系统消息中
descriptionOptional[str]None添加到系统消息开头的团队描述
instructionsOptional[Union[str, List[str], Callable]]None团队的指令列表
expected_outputOptional[str]None提供团队的预期输出
additional_contextOptional[str]None添加到系统消息末尾的附加上下文
success_criteriaOptional[str]None定义团队的成功标准
markdownboolFalse如果 markdown=true,则添加指令以使用 markdown 格式化输出
add_datetime_to_instructionsboolFalse如果为 True,则将当前日期时间添加到指令中,让团队了解时间
add_location_to_instructionsboolFalse如果为 True,则将当前位置添加到指令中,让团队了解位置
add_member_tools_to_system_messageboolTrue如果为 True,则将团队成员可用的工具添加到系统消息中
knowledgeOptional[AgentKnowledge]None向团队添加知识库
knowledge_filtersOptional[Dict[str, Any]]None要应用于知识库搜索的过滤器
enable_agentic_knowledge_filtersOptional[bool]False让代理选择知识过滤器
retrieverOptional[Callable[..., Optional[List[Dict]]]]None用于获取引用的自定义检索函数
references_formatLiteral["json", "yaml"]"json"引用的格式
contextOptional[Dict[str, Any]]None用户提供的上下文
add_contextboolFalse如果为 True,则将上下文添加到用户提示中
enable_agentic_contextboolFalse如果为 True,使团队代理能够更新团队上下文并自动将团队上下文发送给成员
share_member_interactionsboolFalse如果为 True,则将所有先前的成员交互发送给成员
get_member_information_toolboolFalse如果为 True,则添加一个用于获取团队成员信息的工具
search_knowledgeboolTrue添加一个搜索知识库的工具(即 Agentic RAG)
read_team_historyboolFalse如果为 True,则读取团队历史记录
toolsOptional[List[Union[Toolkit, Callable, Function, Dict]]]None提供给模型的工具列表
show_tool_callsboolTrue在团队响应中显示工具调用
tool_call_limitOptional[int]None允许的最大工具调用次数
tool_choiceOptional[Union[str, Dict[str, Any]]]None控制团队模型调用哪个(如果有)工具
tool_hooksOptional[List[Callable]]None在工具调用之前和之后调用的钩子列表
response_modelOptional[Type[BaseModel]]None团队响应的响应模型
parser_modelOptional[Model]None用于解析响应的模型
parser_model_promptOptional[str]None用于解析响应的提示
use_json_modeboolFalse如果设置了 response_model,则设置模型的响应模式
parse_responseboolTrue如果为 True,则解析响应
memoryOptional[Union[TeamMemory, Memory]]None团队记忆存储
enable_agentic_memoryboolFalse启用代理来管理用户记忆
enable_user_memoriesboolFalse如果为 True,代理将在运行结束时创建/更新用户记忆
add_memory_referencesOptional[bool]None如果为 True,代理会在响应中添加对用户记忆的引用
enable_session_summariesboolFalse如果为 True,代理将在运行结束时创建/更新会话摘要
add_session_summary_referencesOptional[bool]None如果为 True,代理会在响应中添加对会话摘要的引用
add_history_to_messagesboolFalse如果为 True,则将聊天历史记录中的消息添加到发送给模型的消息列表中。
num_history_runsint3包含在消息中的历史运行次数
storageOptional[Storage]None团队存储
extra_dataOptional[Dict[str, Any]]None与此团队一起存储的额外数据
reasoningboolFalse启用团队推理
reasoning_modelOptional[Model]None用于推理的模型
reasoning_min_stepsint1最少推理步数
reasoning_max_stepsint10最多推理步数
streamOptional[bool]None从团队流式传输响应
stream_intermediate_stepsboolFalse流式传输团队的中间步骤
stream_member_eventsboolTrue流式传输团队成员的事件
store_eventsboolFalse将流式事件存储在 TeamRunResponse 上
events_to_skipOptional[List[Union[RunEvent, TeamRunEvent]]]None指定在 TeamRunResponse 上存储事件时要跳过的事件类型
app_idOptional[str]None可选的应用 ID。指示此团队是应用的一部分
debug_modeboolFalse启用调试日志
show_members_responsesboolFalse启用成员日志 - 为团队和成员设置 debug_mode
monitoringboolFalse将团队信息记录到 agno.com 以进行监控
telemetryboolTrue为分析记录最小遥测数据

函数

函数描述
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: 最多推理步数