从市场克隆智能体
什么时候用
当你需要快速获得一个现成可用的智能体时——市场里的智能体由平台管理员维护,包含预设的人设、技能和配置,可以直接克隆到你的"我的智能体"中使用,无需从零创建。尤其适合刚上手平台,或者想复用通用场景(如客服、翻译、代码助手)智能体的情况。
你需要准备
- 已登录管理员账号(市场对所有账号开放浏览)
- 准备好对克隆后的智能体进行后续个性化调整(如果需要)
操作步骤
第 1 步:进入智能体市场
左侧菜单 → 智能体管理 → 智能体市场。
页面以卡片网格展示所有公共智能体,包括:
- 智能体名称和描述
- 类型标签(独立/编排)
- 所属分类标签
- 卡片右上角有「详情」和「添加到我的智能体」按钮
第 2 步:浏览、搜索或筛选智能体
搜索: 在页面顶部搜索框输入关键词,按回车搜索,匹配智能体的名称和描述。
分类筛选: 搜索框下方是分类筛选栏,点击「全部」显示所有,点击具体分类只显示该分类下的智能体,也可以选择「未分类」查看无分类的智能体。
查看详情: 点击卡片上的「详情」按钮,弹出详情弹窗查看完整配置(包括 System Prompt、绑定的模型和技能等)。
第 3 步:克隆智能体
找到想要的智能体后:
- 点击卡片上的「添加到我的智能体」按钮
- 在确认弹窗中点击「确定添加」
- 看到成功提示后,智能体已自动添加到你的"我的智能体"列表中
克隆后的智能体:
- 名称会自动追加「(副本)」以区分
- 完全独立,不会随市场原版更新而变化
- 你可以像编辑自己创建的智能体一样编辑它
怎么验证成功了
- 左侧菜单 → 智能体管理 → 我的智能体
- 在列表中找到刚才克隆的智能体(名称带「(副本)」)
- 点击卡片上的「编辑」,查看配置是否完整
- 为该智能体分配用户并创建 API Key,用 OpenAI SDK 调用,确认正常工作
常见问题
克隆时提示 403 禁止访问
可能的原因:
- 你试图克隆的不是市场智能体,而是其他账号的私有智能体(市场智能体都标有「公共」标签)
- 解决:只克隆标记为「公共」的市场智能体,或联系平台管理员申请授权
克隆后的智能体不随市场更新
这是正常设计。克隆的智能体是你的独立副本,原版后续的修改不会影响你的副本。如果你想要使用最新版本,需要重新克隆。
想把自己的智能体放到市场
不能直接发布智能体到市场。市场智能体由平台管理员维护,如需将你的智能体加入市场,请联系平台管理员评估。
深入
市场机制
- 平台管理员创建的系统 Agent(tenant_id = 0,且 is_market_item = True)会出现在市场中
- 所有租户都可以从市场浏览和克隆(clone)Agent
- 克隆后的 Agent 归属当前租户,名称自动追加「(副本)」,is_market_item 变为 False
- 平台没有 is_public 字段,市场可见性由 tenant_id = 0 + is_market_item = True 共同决定
权限边界
| 操作 | 谁可以 |
|---|---|
| 克隆市场 Agent | 任何租户的 admin |
| 克隆其它租户的 Agent | 不允许 |
| 修改系统市场 Agent | 仅平台管理员 |
常见坑
- 没有 is_public 字段:如果你想把自己的 Agent 公开给其它租户,需要联系平台管理员
- 克隆其它租户的 Agent 会被拒绝:只允许克隆市场 Agent(tenant_id = 0)或本租户自己的 Agent
排错速查
| 症状 | 可能原因 |
|---|---|
| 克隆 Agent 被拒绝 | 目标不是市场 Agent 也不是本租户 Agent |