Multica Docs

创建和配置智能体

选择起点，定义智能体的职责、能力、运行方式和 Access。

创建智能体前，需要先有一个可用的运行时。运行时决定这名智能体使用哪台电脑和哪款 AI 编程工具；智能体则保存它长期使用的身份、指令和能力。

在工作区的 智能体 页面点 新建智能体。

选择起点

创建页面提供两种方式：

方式适合什么情况
从空白开始已经知道智能体的职责，想自己填写每项配置。
通过 AI 创建先描述目标，让 Agent Builder 追问关键信息并生成草稿。

通过 AI 创建需要一个在线运行时来完成 Builder 对话。无论选择哪种方式，创建前都可以检查并修改最终配置。

创建智能体的起点选择页：Start blank 与 Build with AI

必填项

创建智能体只要求两项：

  • 名称：在当前工作区中必须唯一。
  • 运行时：选择实际 task 的环境。

其他字段可以先使用默认值，创建后再调整。新智能体默认只有创建者可以运行。

描述与指令

描述是写给团队看的简短介绍，只显示在智能体列表和详情中，不会进入 AI 编程工具的提示。

指令会在每次执行时提供给智能体，通常包含：

  • 它负责什么、不负责什么；
  • 收到工作后先检查什么；
  • 允许修改哪些内容；
  • 结果的提交方式；
  • 什么时候需要向成员确认。

例如：

你负责审查前端 Pull Request。

先阅读改动和相关测试，只检查：
- React 与 TypeScript 的正确性
- 可访问性
- 与现有组件模式是否一致

不要直接修改代码。把问题按严重程度写在 issue 评论中；
没有阻塞问题时，明确说明可以合并。

添加 skill

创建时可以从工作区选择一个或多个 skill。

Skill 适合保存可以跨智能体复用的方法和资料；只属于这名智能体的长期要求写在指令中。

对话开场建议

最多添加三条对话开场建议，让用户在发送第一条消息前了解这个智能体擅长什么。它们出现在别人与该智能体开始新对话时，位于输入框上方。每项包含一个简短标题和一条完整提示词。选择后只会填入输入框，用户可以先检查或修改，不会自动开始执行。

编辑器下方会预览新对话的实际效果；有编辑权限的人还会在那个空状态里看到自定义开场建议入口，点击可直接跳回这里。

留空时，对话页会显示本地化的通用默认值。针对智能体职责和边界编写的示例通常更有帮助。

选择运行时、模型和思考强度

运行时已经对应一款 AI 编程工具。选择运行时后，可以继续选择该工具支持的模型和思考强度；部分工具（如 Codex）还可选择速度档：

  • 留空时，使用运行时或本地 CLI 的默认配置。
  • 设置模型后，该智能体之后领取 task 时会使用这个覆盖值。
  • 某些运行时自行管理模型，因此不会显示模型选择。

不同工具支持的模型、会话恢复、skill 和 MCP 能力不同，见AI 编程工具对照。

设置 Access

Access 决定哪些成员可以运行这名智能体（分配、@提及或对话）：

Access含义
仅自己（Only me）只有你可以运行。默认选项。
整个工作区（Entire workspace）所有工作区成员都可以运行。
指定成员（Specific people）只有你和选中的成员可以运行。

Access 设置：仅自己、整个工作区、指定成员三档

只有智能体 owner 可以修改 Access，工作区管理员也不行。工作区 owner 和 admin 可以管理其他配置，但不能借管理员身份运行未授权的智能体。

创建后的配置项

打开智能体详情页，可以继续调整：

配置作用
并发上限同一名智能体最多同时执行多少条 task，默认是 6；达到上限后继续排队。
环境变量在 AI 编程工具启动时注入变量。
自定义参数逐项追加到 AI 编程工具的 CLI 参数中。
MCP为支持的 AI 编程工具提供 MCP server 配置。
集成连接这名智能体可以使用的外部服务。

运行时所在的守护进程还有一个全局并发上限（默认 20），实际并发取两者中的较小值。

修改配置不会改变已经运行中的 task。后续 task 被运行时领取时，会使用当时保存的智能体配置。

环境变量与凭据

环境变量适合放这名智能体执行时需要的有限权限凭据，例如只读 API key 或单一 scope 的 token。

custom_env 的值在 Multica 服务器的数据库里是明文存储的，不属于"只留在本机"的数据。agent list/get 接口不再返回任何 env 值，只返回键的数量；只有工作区 owner、admin 可以解锁和修改，并且每次读取或修改都会留下审计记录。运行中的智能体不能调用管理接口读取其他智能体的变量。

不要使用生产数据库的管理员密码或其他高价值长期凭据。

PATH、HOME 和 MULTICA_* 等运行环境关键变量不能通过这里覆盖。

自定义参数和 MCP

自定义参数按数组逐项传给 AI 编程工具，不经过 shell 展开。参数名称是否有效由对应工具决定；已有独立字段的模型配置不需要在这里重复设置。

不要把凭据或其他 secret 放进自定义参数。它们会留在子进程的 argv 中，同机其他进程可能通过 ps 或 /proc 看到；请改用环境变量（custom_env）。守护进程日志会遮蔽参数值，但无法保护操作系统的进程列表。

MCP 配置可能包含 token，保存与展示规则和环境变量相同。只有支持托管 MCP 配置的运行时会显示这一项；不支持的工具不会因为保存了配置就自动获得 MCP 能力。

复制智能体

复制会带上名称之外的大部分工作配置，包括指令、对话开场建议、skill、自定义参数、头像、并发上限和 Access 设置。模型、思考强度和速度档也会一并带走；如果原运行时不可用、复制被迫换到其他运行时，这三项会清空，需要重新选择。

环境变量的值和 MCP 配置在任何情况下都不会复制，需要在新智能体中重新设置。复制会保留原智能体的运行时绑定和 Access 设置。

使用 CLI 创建

multica agent create \
 --name "Frontend Reviewer" \
 --runtime-id <runtime-id> \
 --description "审查前端 Pull Request" \
 --instructions "先阅读改动和测试，只在 issue 评论中提交审查结论。"

命令行参数中的明文会进入 shell 历史；stdin 和权限受限的文件不会。

已有配置相近的智能体时，可以直接复制：

multica agent copy <agent-id>

默认复制到同一运行时；加 --runtime-id 换到其他运行时，必须同时指定 --model。环境变量、MCP 配置和 runtime_config 永不复制；运行时绑定本身会保留。完整参数见使用 CLI。

接下来

智能体

智能体是在工作区中反复使用的一套身份、能力和执行配置。

Skills

把常用的指令、步骤和资料整理成可供多个智能体复用的 skill。

本页目录

选择起点必填项描述与指令添加 skill对话开场建议选择运行时、模型和思考强度设置 Access创建后的配置项环境变量与凭据自定义参数和 MCP复制智能体使用 CLI 创建接下来