Poco 使用手册
平台说明

专家工作台与专家团架构

当前专家入口、目录安装、团队编排、分享与执行快照的实现边界。

专家工作台已实现单专家、公共目录、用户分享、使用统计与外部嵌入管理;专家团提供独立列表、开始页和专业模式画布编辑。本页说明现有实现,用户操作见 场景专家 和 专家团。

页面与上下文

路径用途
/home业务概览或办公任务输入,由账号模式决定
/agents-workbench专家工作区、目录与分享入口;办公模式也集中展示专家团
/agents/free自由选择能力的新任务入口
/agents/{agentId}单专家开始页
/agent-teams专家团列表
/agent-teams/{agentId}专家团开始页
/agent-teams/{agentId}/edit专业模式团队画布

路由实际带语言前缀。全局导航与专家内的会话上下文分别处理;未绑定 Agent 的会话使用自由入口。专业和办公模式共享资源与执行链路,但导航、展示和编辑入口不同。

资源、安装与授权

公共目录由管理员维护,用户安装到自己账号后使用;私人专家和团队由账号自行维护。分享资源保存配置快照,可通过链接导入或公开到用户分享市场。来源更新由接收者确认,不自动覆盖已保存的会话或定时任务。

Skill、MCP 等依赖按资源匹配与冲突规则处理;连接器携带依赖声明,绑定用户自己的授权。包定义、个人账户和专家绑定是不同层次。目录预检与开始页就绪检查都需确认当前用户权限、模型和连接账户,不能通过资源安装传递作者凭据。

编排与执行

专家团由一个主控与 2–32 个成员组成,成员必须为单个专家,不能重复或嵌套团队。画布保存成员顺序、角色职责、主控安排、开始页展示和节点位置。连线表达协调关系,不表达固定 DAG 执行顺序。

保存编排时生成不可变快照;开始运行时解析当次模型与连接账户。一个团队任务进入一条会话,由主控委派成员并汇总,成员不再委派其他成员。团队不使用成员间消息或共享任务板。

模型与同一连接器的账号可按运行规则读取当前有效选择,成员技能和工具范围仍以快照为准。来源专家不可用时,编辑器要求处理不可用成员;历史运行展示当次实际解析配置。

会话、调度与 API

新会话采用创建时配置,后续消息保持该会话能力边界。定时任务保存独立编排;明确采用当前团队配置时更新任务快照,复用会话模式创建新会话,保留旧历史。

conversation scope API Key 可固定绑定专家或团队,创建后不可更换目标。绑定目标提供能力,不能从 Key 表单再复制另一套成员配置。不同 Key 的会话归属仍隔离。

单专家支持外部嵌入,创建者可查看外嵌对话;专家团当前不支持。嵌入与分享导入是不同的身份和资源契约。

源码入口

  • 页面与画布:frontend/app/[lng]/(shell)/agent-teams/、frontend/features/agents/。
  • 导航:frontend/components/shared/sidebar/sidebar-nav-config.ts 与办公导航组件。
  • 团队、安装和分享:backend/app/services/agent_team_service.py、agent_profile_share_service.py。
  • 执行准备:executor_manager/app/services/run_pull_service.py。
  • 成员装配与工具权限:executor/app/core/engine.py。

开发时同时检查资源权限、依赖就绪、快照和当次模型,避免把页面当前配置当作历史运行配置。实际流程参见 专家团最佳实践。

On this page