在哪里使用插件
entrypoints 决定插件能从哪里调用:
"entrypoints": { "conversation": true, "task": true, "automation": false }
在对话中:/
在新对话里输入 /,选择一个插件。可选的插件包括:
- 你本机已启用的个人插件;
- 当前公司已发布、你有权看到、已经绑定,并且你已安装当前版本的组织插件。
| 规则 | 详情 |
|---|---|
| 每轮最多 | 3 个插件 |
| 版本 | 按每一轮消息固定。排队、切换对话或之后的升级,都不会改变已发送的那一轮 |
| 校验 | 组织插件由 Hub 重新校验组织、可见范围、信任、绑定和个人安装。客户端的选择不能绕过授权 |
| 项目插件 | 只在唯一适用的项目或明确的项目上下文中可用;有多个项目、无法判断时会被阻止 |
| 对话里显示什么 | 只显示名称、版本和作用域,不显示绑定配置、密钥引用和包路径 |
在对话里用插件,只是把它的方法、质量标准和 AI 节点说明用于这次对话,不会执行脚本、审批、合并或发布。
公司切换已绑定的版本后,目录只会提示有可用升级,不会悄悄替换你已经接受的版本。你确认升级后,新版本才用于之后的对话。
作为任务
需要多个 Agent、节点级的模型、证据检查点、重试或环境发布时,请创建任务并选择这个工作流。
- 在对话里输入
/选择 新建需求(也可以输入"创建任务")。确认草稿后,需求会关联到当前对话;正文、验收标准和附件作为任务轮次发送。 - 从待办或 AI 工作台打开任务时,会打开它关联的原对话,不会新建对话,也不会因为查看而启动执行。
- 手动添加的任务和派给对话的工作共用一个队列。前一项完整结束后才发送下一项;等待审批不算完成。
个人插件只用于本机的对话试用。要从任务运行完整的工作流,请先把它上传为组织候选版本,完成审查和绑定(见发布到组织)。
在自动化中
entrypoints.automation 为 true 时,员工的自动化计划可以调用这个版本。
- 计划只保存经过审批的绑定 ID 和插件声明的普通输入。密钥不进入计划,而是在每个节点运行时从绑定的密钥引用注入。
- 本机自动化会创建一个普通对话,把任务内容、参数和锁定的插件快照作为一轮消息发送。
- 组织工作流的绑定和远程派活,仍按受控的任务执行方式运行。
- 插件被停用、撤销授权、缺少必填输入或条件未就绪时,计划会失败并给出可读的原因,不会悄悄改成普通 Agent 执行。