Core Concepts
エージェント
An Agent は、特定の目的、システムプロンプト、LLMプロバイダー、および接続されたツールで構成されたAI駆動のアシスタントです。NPOは2種類のエージェントをサポートしています：
- Single Agent: 自立して動作するスタンドアロンエージェントで、独自のLLM、ツール、およびスキルを持っています。
- Deep Agent: メインエージェントが1つ以上のサブエージェントにタスクを委任するマルチエージェントアーキテクチャで、各サブエージェントは独自のLLM、ツール、およびスキルを持っています。
MCPサーバー
MCP (Model Context Protocol) Servers は、エージェントが外部システムやAPIと対話するために使用できるツールを提供します。MCPサーバーは次のように分類できます：
- Internal: NPOプラットフォーム内で管理されます。
- External: サードパーティサービス（例：Notion、AWS、DuckDuckGo Search）から接続されます。
スキル
Skills は、エージェントの動作を標準化する再利用可能な指示セット（SKILL.mdファイルで定義）です。スキルには、ワークフロー定義、ツール使用パターン、およびドメイン特有の知識が含まれる場合があります。これらはスキルレジストリを通じて管理され、エージェントやチーム間で共有できます。
ミドルウェア
Middleware レイヤーは、エージェントの相互作用に処理制御を追加します：
- Human in the Loop: 特定のツールを実行する前に人間の承認を必要とし、ツール呼び出しを承認、編集、または拒否するオプションがあります。
- PII Protection: 入力、出力、およびツール結果内の機密データ（メール、クレジットカード、IP、MACアドレス、URL）を自動的に検出して削除します。
- Summarization: LangChainを使用して会話履歴を圧縮し、重要な情報を保持しながらコンテキストウィンドウの制限を管理します。
知識DB
Knowledge Databases は、エージェントが会話中にドメイン特有の知識のためにアップロードされた文書（PDF、XLSX、CSV、PPTX）を参照できるようにします。
オブジェクト依存関係の概要
| オブジェクト | 使用者 / 依存先 |
|---|---|
| LLM Provider | エージェント LLM ノード、要約 LLM |
| Model | エージェント LLM ノード (デフォルトモデル)、要約 (デフォルトモデル) |
| API Key (LLM_PROVIDER) | エージェント LLM ノード、要約 LLM |
| API Key (BACKEND_SERVER) | バックエンドサーバー認証 |
| Kubernetes Cluster | MCP インスタンスプロビジョニング、エージェントデプロイメント |
| Backend Server | MCP プロファイル (バックエンドとして登録) |
| MCP Profile | MCP インスタンス (プロファイルからプロビジョニング) |
| OAuth Credentials | MCP プロファイル認証、プレイグラウンドコネクタ認証 |
| Tools (API Endpoints) | MCP プロファイル → エージェント (呼び出し可能なツールとして公開) |
| MCP Instance | エージェント (ツールを提供)、ヒューマンインザループ (ツールごとのルール) |
| External MCP | エージェント (MCP レジストリを介してツールを提供) |
| Provisioning Spec | MCP インスタンス (レプリカ、CPU、メモリ、アフィニティ、トレランス) |
| Network Spec | MCP インスタンス (ClusterIP/NodePort、Ingress、TLS) |
| Skill | エージェント (モジュラー命令セットとして添付) |
| SKILL.md | スキル (動作とワークフローを定義) |
| Skill Files | スキル (スクリプト、参照、アセット) |
| Skill Version | スキル (エージェントによって使用されるピン留めされたバージョン) |
| Trigger | エージェント (エントリーポイント: チャットボット、Webhook、スケジューラー) |
| Chat Memory | エージェント (PostgreSQLを介した会話の永続性) |
| User | グループ (メンバーシップ)、ロール (割り当て)、スキル (共有)、エージェント (共有) |
| Group | ユーザー (メンバーを含む)、ロール (割り当て)、スキル (共有)、エージェント (共有) |
| Role | ユーザー (アクセス制御)、グループ (アクセス制御) |
| Human in the Loop | エージェントミドルウェア → MCP サーバーごとのツール権限ルール |
| PII Protection | エージェントミドルウェア → 入力、出力、ツール結果をスキャン |
| Summarization | エージェントミドルウェア → 自身の LLM + API キーを使用 |
| Playground | エージェント (テスト)、コネクタ (MCP 認証)、スキル (検証) |
| Published Agent | NPOワークスペースチャットインターフェース |
| Conversation History | NPOワークスペース（チャットセッションごとに保存） |
| Theme / Color | NPOスタジオUIのパーソナライズ |