参数 | 类型 | 默认值 | 描述 |
---|---|---|---|
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 | 替换团队的工具 |
团队可以以三种不同的模式运行:
"route"
- 将任务路由到特定团队成员"coordinate"
- 在团队成员之间进行协调(默认)"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
: 最多推理步数