zkeviny 多Agent安全协作(单设备)
一句话定位
基于 MGC 的单设备多 Agent 任务链协作方法论，通过主 Agent 调度、脚本角色编写、 执行 Agent 执行，实现敏感资源零暴露的安全协作。
解决的问题
| 痛点 | 解决方案 |
|---|---|
| 多 Agent 共用环境，密钥易泄露 | 密钥存入 MGC，Agent 无接触执行 |
| 脚本内容暴露给所有 Agent | 脚本存入 MGC，执行时零暴露 |
| 缺乏任务协作方法 | 主 Agent 任务链编排模板 |
| 子 Agent 越权访问敏感资源 | 执行 Agent 提示词约束 |
核心概念
MGC 在协作中的角色
MGC 是 本地敏感资源托管与执行层：
- 用户 通过 WebUI（浏览器或 mgc_open_webui）存入密钥和脚本
- 脚本角色 编写脚本并通过 mgc_save 存入 MGC
- 主 Agent 编排任务链，指定调用时机；在子 Agent 失败或用户授权时可直接执行
- 执行 Agent 只调用 mgc_run，不接触密钥和脚本
四种角色
| 角色 | 职责 | 能力 |
|---|---|---|
| 用户 | 存入密钥/脚本，下达目标 | WebUI / mgc_open_webui |
| 主 Agent | 任务拆解，编排调度，在授权/子Agent失败时执行 | mgc_list, mgc_run |
| 脚本角色 | 编写脚本，存入 MGC | mgc_save, mgc_get, mgc_list |
| 执行 Agent | 完成非敏感任务 | mgc_run, mgc_list |
注：敏感操作（mgc_get 获取明文）需要用户授权后执行
协作流程
用户 ──存入密钥/脚本(WebUI)──> MGC
│
▼
用户 ──下达目标──> 主 Agent
│
├──拆解任务链
│
▼
┌───────┴───────┐
▼ ▼
脚本角色 执行 Agent
(编写脚本) (完成任务)
│ │
▼ ▼
mgc_save mgc_run
│ │
└───────┬───────┘
▼
MGC 执行
(返回结果)
快速开始
前置条件
- 安装 MGC v1.4.7+
- 配置 MCP（在 AI 客户端添加以下配置）：
{ "mcpServers": { "mgc-blackbox": { "command": "mgc", "args": ["--mcp"] } } } - 通过 WebUI 或 mgc_open_webui 存入敏感资源：
- API 密钥
- 数据库凭证
- 业务脚本
步骤 2：配置主 Agent
在主 Agent 系统提示词中加载 prompts/master_agent.md
步骤 3：配置脚本角色
加载 prompts/script_agent.md
步骤 4：配置执行 Agent
加载 prompts/executor_agent.md
步骤 5：开始协作
用户下达任务后，主 Agent 自动拆解任务链并协调子 Agent 完成。
提示词模板
prompts/master_agent.md
主 Agent 提示词模板，包含：
- 任务拆解方法
- MGC 调用时机
- 子任务分配规则
prompts/script_agent.md
脚本角色提示词模板，包含：
- mgc_save 使用方法
- 脚本命名规范
- 脚本位置汇报格式
prompts/executor_agent.md
执行 Agent 提示词模板，包含：
- mgc_run 调用方法
- 禁止行为清单
- 结果处理规范
prompts/cooperation_best_practice.md
最佳实践文档，由主 Agent 自动维护：
- 协作流程
- 可复用脚本列表
- 参数规范
- 用户偏好
- 常见错误与修复
- 场景最佳实践
- 协作记录及用户反馈
MGC 工具使用
mgc_save（脚本角色使用）
# 存入脚本
mgc_save(
info_type="script",
info_owner="数据查询脚本",
ext01="python",
content="""# 脚本内容..."""
)
mgc_run（执行 Agent 使用）
⚠️ 注意：部分 MCP 客户端可能存在 ext02 JSON 对象序列化的兼容性问题，建议使用 JSON 字符串格式。
# 执行脚本
mgc_run(
info_type="script", # 必填，指定类型为脚本
info_owner="数据查询脚本", # 必填，脚本名称
diff_1="v1", # 必填，版本号或分支标识
ext02='{"param1": "value1"}' # 可选，JSON 字符串格式的执行参数
)
mgc_list（所有 Agent 可用）
注：mgc_list 仅查看信息列表，不获取明文，所有 Agent 都可使用。
# 查看可用脚本
mgc_list(info_type="script")
mgc_open_webui（用户使用）
用于让 AI 打开 MGC WebUI，方便用户存入敏感资源。
# 打开 WebUI
mgc_open_webui()
安全边界
此技能提供
- 协作方法论框架
- 提示词模板
- MGC 工具调用规范
此技能不提供
- MGC 权限强制管控（依赖提示词约束）
- 自动密钥管理
- Agent 身份鉴权
⚠️ 重要提醒
- 所有敏感资源必须用户通过 MGC WebUI 存入
- 执行 Agent 只能调用 mgc_run，禁止读取脚本内容
- 主 Agent 需明确告知子 Agent 调用时机和脚本位置
- 敏感操作结果返回后，主 Agent 负责更新任务状态，协调子Agent协作
常见问题
| 问题 | 解答 |
|---|---|
| 存入MGC的信息是否会同步云端？ | MGC是一个本地工具，不具备主动联网能力 |
| MGC的主要能力？ | 安装MGC后查看 ~/.mgc/skills/mgc_skill.md |
| 子 Agent 能否绕过 MGC？ | 提示词约束无法完全禁止，需确保子 Agent 无法访问本地脚本文件 |
| 如何隔离不同任务的脚本？ | 通过 info_owner 命名区分，如 任务A_查询脚本、任务B_发布脚本 |
| 主 Agent 如何知道有哪些脚本？ | 使用 mgc_list 查看，或由脚本角色汇报 |
相关资源
- MGC 核心仓库: https://github.com/zkeviny/MGC-Blackbox
- MGC 安装:
pip install mgc-blackbox - WebUI: http://127.0.0.1:57218
- API: http://127.0.0.1:57219
- MGC接口鉴权token：~/.mgc/database/mgc_black_box/.mgc_token
- 问题反馈: mirgincipher@outlook.com
更新日志
v1.0.0
- 初始版本
- 提供主 Agent、脚本角色、执行 Agent 三套提示词模板
- 包含完整协作流程说明