コンテンツへスキップ
PentAGI
Enterprise

PluginsとMCP

agent-plugins.org形式のポータブルなpluginsとスキル、およびStreamable HTTPまたはSSEを介した独自のMCP serversを使用して、Enterprise agentsを拡張します。

Enterpriseは、Agent Pluginsを通じてagentsの機能を拡張します。これらは、スキル、MCP server宣言、およびPentAGI固有のagent profilesを含む、オープンなagent-plugins.org形式のパッケージです。

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

段階的な情報開示

plannerには、各pluginの名前、短い説明、スキル名、および必要なMCP serversが表示されます。選択されたpluginsのスキルは実行中のagentのプロンプトに組み込まれ、それらのMCP関数はagentのtoolsとなります(subtaskあたり最大20個)。スクリプトと参照資料はコンテナ内で必要に応じて読み込まれるため、実際にpluginが選択されるまで、大規模なカタログによるコストはほとんどかかりません。

MCP servers

設定画面のMCP servers

MCP serversは、Settings → MCP ServersからStreamable HTTPまたはレガシーHTTP+SSE経由で接続されます。stdioのみをサポートするサーバーは、ネットワーク上のMCPゲートウェイの背後で実行されます。PentAGIは、sandboxの外でplugin提供の実行ファイルを起動することはありません。

PentAGIは、MCP_ALLOWED_EGRESS_CIDRSに範囲がリストされていない限り、プライベート、ループバック、リンクローカルおよびメタデータアドレス上のMCPエンドポイントを拒否します。そのため、ネットワーク上のゲートウェイの場合はそのプレフィックス(例:10.8.0.0/24)を設定してください。プレーンHTTPは、localhost、ループバックアドレスおよびhost.docker.internalに対してのみ許可されます。

新しいサーバーは、Availability で On に切り替えるまでオフのままです。管理者は Default for users を設定し、各ユーザーは My state でこれを上書きできます。agent は、その関数をバインドする plugin を介してサーバーにアクセスするか、Offer without a plugin を有効にして関数を選択(Allow direct use)すると、直接アクセスできます。

認証情報は書き込み専用です。サーバーを追加する際に入力し、後で置き換えたり失効させたりできます(失効させるとサーバーもオフになります)。APIが認証情報を返すことはありません。認証情報はMCP_CREDENTIALS_ENCRYPTION_KEY(64桁の16進数文字列。インストーラーが生成します)で暗号化されます。このキーをバックアップしてください。認証情報が保存されると、PentAGIはこのキーなしでは起動しません。

Plugins

設定画面のplugins

Settings → Pluginsで、New pluginまたはImport package(.tar.gzファイル)を使用してpluginを追加します。インポートされたpackageはドラフトとして扱われ、公開するまで利用できません。PLUGINS_DIR(コンテナ内の/opt/pentagi/plugins)に配置されたpackageは、Reload registryを実行するとBundled runtime pluginsに表示されます。

plannersがpluginsを利用できるのは、そのpluginsが必要とするMCP serversがインストールされ有効化されている場合に限られます。管理者は各pluginのDefault for users(On、Default、またはOff)を設定し、各ユーザーはbundled pluginsについてはMy stateで、それ以外についてはMy overrideでこれを上書きできます。DefaultはPLUGINS_ENABLEMENT_MODEに従います:auto(デフォルト)は、MCP serversが準備完了のすべてのpluginを提供しますが、manualはpluginがOnに切り替えられた場合にのみ提供します。

最終更新日