跳到主要内容
PentAGI
Enterprise

Plugins 与 MCP

通过 agent-plugins.org 格式的便携式 plugins 和技能,以及基于 Streamable HTTP 或 SSE 的自有 MCP servers,扩展 Enterprise agents。

Enterprise 通过 Agent Plugins 扩展 agents 的能力——这些 plugin 包采用开放的 agent-plugins.org 格式,包含技能、MCP server 声明以及 PentAGI 特定的 agent profiles。

my-plugin/
├── plugin.json      manifest (required)
├── skills/          Agent Skills
├── mcp.json         MCP server declarations
└── com.pentagi/     requirements and agent profiles

渐进式披露

planner 仅能看到每个 plugin 的名称、简短描述、其技能名称以及所需的 MCP server。其所选 plugins 的技能会被纳入工作 agent 的提示词中,它们的 MCP 函数会成为 agent 的 tool——每个 subtask 最多 20 个——而脚本和参考资料则在容器内按需读取,因此,在 plugin 被选中之前,庞大的目录几乎不会带来任何开销。

MCP servers

设置中的 MCP servers

MCP servers 通过 Settings → MCP Servers 以 Streamable HTTP 或旧版 HTTP+SSE 方式进行连接。仅支持 stdio 的服务器需在您的网络上通过 MCP 网关运行;PentAGI 绝不会在其 sandbox 之外执行 plugin 提供的可执行文件。

除非 MCP_ALLOWED_EGRESS_CIDRS 列出了该范围,否则 PentAGI 会拒绝私有地址、环回地址、链路本地地址和元数据地址上的 MCP endpoint;因此,对于您网络上的 gateway,请设置其前缀,例如 10.8.0.0/24。仅对 localhost、环回地址和 host.docker.internal 接受纯 HTTP。

新服务器在 Availability 下切换为 On 之前保持关闭状态:管理员设置 Default for users,每位用户可以在 My state 下覆盖此设置。agent 通过绑定其功能的 plugin 访问服务器,或者在您启用 Offer without a plugin 并选择功能(Allow direct use)后直接访问。

凭据为只写:您在添加服务器时输入凭据,之后可以替换或撤销它们——撤销也会将服务器关闭——且 API 永远不会返回这些凭据。它们使用 MCP_CREDENTIALS_ENCRYPTION_KEY(64 个十六进制字符;安装程序会生成一个)进行加密。请备份该密钥:一旦存储了凭据,PentAGI 没有它就无法启动。

Plugins

设置中的 plugins

在 Settings → Plugins 中,通过 New plugin 或 Import package(.tar.gz 文件)添加 plugin;导入的 package 会以草稿形式存在,只有在发布后才会提供使用。放置在 PLUGINS_DIR(容器内的 /opt/pentagi/plugins)中的 packages 会在点击 Reload registry 后显示在 Bundled runtime plugins 下。

只有当 plugin 所需的 MCP server 已安装并启用时,planner 才能使用这些 plugin。管理员为每个 plugin 设置 Default for users — On、Default 或 Off — 每位用户都可以在 My state(针对 bundled plugins)或 My override(针对其他 plugin)下覆盖此设置。Default 遵循 PLUGINS_ENABLEMENT_MODE:auto(默认值)会提供所有 MCP server 就绪的 plugin,而 manual 仅在 plugin 被切换为 On 时才提供。

最后更新于