Skip to Content
Admin Guideエージェント管理

エージェント管理

AIPのエージェント作成、構成、活用ガイド

主要機能

AIPのエージェントは、単純なチャット機能を超えて、組織内の様々なツールと知識を結びつける業務特化型AIインターフェースです。ユーザーは自然言語でリクエストを入力し、エージェントは定義された目的とツールに基づいて自動化された応答を提供します。

概念定義

エージェントは以下の要素で構成されます：

  • Instruction (行動指針): LLMにどのような役割と行動を実行するかを定義
  • LLMモデル: GPT-4、ClaudeなどのAIモデルを選択してエージェントの知能基盤を提供
  • MCP Tool (外部システムとのインターフェース): GitHub、Notion、Snowflakeなど外部システムと連携
  • Knowledge Bundle (ベクター基盤の組織知識): 組織の文書、データをベクター化して検索可能な知識として活用

この組み合わせは管理者画面で構成され、ユーザーは組織に共有されたエージェントを使用できます。

エージェント構成要素と動作原理

AIPのエージェントは以下のような構成要素で定義します。

構成要素説明
LLM ModelGPT-4、Claudeなど事前登録されたモデルから選択 (今後独自api keyサポート、byok)
Instructionプロンプトレベルの役割定義。LLMにどのような応答を誘導するかを指定
MCP ToolGitHub、Notion、Snowflakeなど外部システム制御のためのツール
Knowledge Bundleファイル、GitHub、Driveなどから収集したデータを埋め込んだ検索ソース

エージェントタイプ

エージェントは2つのタイプに分けられます：

  • Built-in: エージェントライブラリを通じてインストールしてすぐに使用できるエージェントです。QueryPie AIPで提供される場合もあり、別の組織に必要なエージェントを事前に設定することもできます。
  • Custom: AIP内で組織の管理者が直接エージェント構成要素を設定して作成できるエージェントです。

エージェント状態

エージェントは以下の3つの状態のうち1つを持ちます：

  • Draft: Custom Agent作成直後またはBuilt-In Agentインストール直後の状態。ユーザーは使用できない状態。
  • Enabled: 正常に構成が完了し、ユーザーに共有・実行可能な状態。一度Enabledに変更するとDraft状態に戻ることはできず、Enabled状態ではエージェントの修正と削除が不可能です。
  • Disabled: 一時的に無効化された状態で、ユーザーに表示されません。

エージェント管理機能

Customエージェント作成

“Create Agent”ボタンをクリックすると、エージェント名と要約情報を入力後、Customエージェントを作成できます。

管理者はエージェント詳細画面で以下の項目を構成できます。

  • Agent Name: エージェントの固有な名前を設定します。組織内で識別しやすい明確な名前を使用することが良いでしょう。
  • Summary: エージェントの機能を1行で要約した短い説明です。ユーザーがエージェントを選択する際の参考になります。
  • Icon: エージェントを視覚的に区別できるアイコンを設定できます。
  • Description: ユーザーに表示するエージェントの詳細な説明です。エージェントが実行できる作業と主要機能を明確に説明します。
  • Prompt Guide: ユーザーにガイドする例示質問です。最大5個まで登録可能で、ユーザーがエージェントをどのように活用できるかを示します。
  • LLM Model: エージェントが使用するAIモデルを選択します。Claude 4.5 Opus、OpenAI GPT 5.2、Google Gemini 3.1 Proなどの最新高性能モデルをサポートしています。
  • Wide Context: （対応モデル専用）最大1Mトークンまでコンテキストウィンドウを拡張し、長い文書や大量のデータを処理できるように設定します。Claude 4.5 Sonnet、Gemini 3.1 Proモデルで有効化できます。
  • Instruction: エージェントの役割と行動指針を定義します。LLMにどのような方式で応答すべきか、どのようなトーンとスタイルを維持すべきかなどを明示します。Instruction作成時、入力欄上部に表示されるEnhance Instructionテキストボタンをクリックすると、簡単な文章（10文字以上）で詳細なInstructionを自動生成できます。
  • MCP Tool追加: 外部システムと連携できるツールを追加します。GitHub、Notion、データベースなど様々なサービスと接続できます。エージェントが使用するCustom MCPでもOAuth連携をサポートしており、DCR(Dynamic Client Registration)のサポート有無にかかわらず、OAuth MCPと互換性があります。
    • Edge Tunnel設定: プライベートネットワークやローカル環境にあるツールを接続する際、Edge Tunnelを使用して安全に連携できます。
      • Personal Edge Tunnel: 個人PCで実行されるトンネルを通じて接続します。
      • Org Edge Tunnel (Enterpriseプラン専用): 組織単位で管理されるトンネルを通じて、チームメンバーが別途トンネルを実行することなくツールを使用できます。
  • Skillを追加: 管理者が登録した共用スキルをエージェントに接続します。Skill管理でアップロードされたスキルを選択すると、エージェントが会話実行中に必要に応じてそのスキルを活用します。
  • Knowledge Bundle: エージェントが参照できる知識ソースを接続します。組織の文書、データベース、ファイルなどをベクター化して検索可能な知識として活用できます。
  • Allow File Upload: 有効にすると、ファイル（テキスト、画像）をアップロードできる機能がユーザーエージェントチャット画面に表示されます。ユーザーはローカルデバイスまたはMy Driveからファイルを選択して作業を実行できます。
  • テストチャット: 画面右側でテキスト対話を通じてエージェントの動作を即座にテストできます。ただし、ファイルアップロード、Artifact機能は使用できません。

MCP Toolは2つの方式で追加可能です：

  • AIPで提供するMCPサーバーおよびツール選択
  • Custom Remote MCP直接登録
⚠️

Authentication Method (認証方式)

エージェントにMCP Toolを追加する際、認証方式を選択できます。

  • 管理者認証委任 (Use with admin-provided credentials): 管理者が認証を事前に完了し、ユーザーにこれを委任する方式。現在のデフォルト値。
  • ユーザー認証必要 (Require User Authentication): エージェントを使用する際、MCPサーバー構成および認証をユーザーが直接行うように提供する方式。(Custom Remote MCPでもOAuth認証をサポートします。)

エージェント詳細ページ

エージェント詳細ページはCustom AgentとBuilt-in Agentによって異なる管理機能を提供します。

Custom Agent

管理者が直接作成したエージェントで、すべての構成要素を自由に修正できます。

  • 完全な編集権限: エージェント名、説明、Prompt Guide、アイコン、LLMモデル、Instructionなどすべての設定を修正可能
  • ToolおよびKnowledge管理: MCP Tool追加/削除、Knowledge Bundle接続/解除など自由な構成
  • 高度設定: Artifact有効化、Max Token設定など詳細オプション調整可能
  • 即座保存: 設定変更時即座に反映され、リアルタイムでエージェント動作確認可能

Built-in Agent

エージェントライブラリからインストールしたエージェントで、制限された編集権限を持ちます。

  • 制限された編集権限: エージェント名のみ修正可能で、核心設定は変更不可
  • Tool連携のみ可能: MCP Tool認証および連携設定のみ追加可能
  • 固定された構成: LLMモデル、Instruction、Knowledge Bundleなどは事前定義された状態維持
  • 安定性優先: 元のエージェントの安定性のため核心設定変更制限

Share Scope設定

エージェント共有範囲を設定する項目で、以下の2つの共有範囲を持ちます。

  • All Users: 組織のすべての構成員がこのエージェントにアクセスできます.
  • Specific Users: 名前またはEメールでユーザーを検索し、特定のユーザーのみエージェントにアクセスできるように設定します.

エージェントライブラリ

エージェントライブラリは、AIPで提供される事前制作されたBuilt-inエージェントを組織でインストールして使用できるようにする機能です。

主要特徴

  • 事前構成されたエージェント: 特定の業務やドメインに最適化されたエージェントを提供
  • 即座使用可能: インストール後すぐに使用できるようすべての構成が完了した状態

インストールおよび使用

  1. エージェント選択: ライブラリから希望するエージェントを選択
  2. インストール: “Install”ボタンをクリックして組織にエージェントインストール
  3. 設定: 必要に応じてMCP Tool連携および認証設定
  4. 有効化: エージェントを有効化してユーザーに共有

ユーザーインターフェース内エージェント使用

管理者がエージェントに属するツール認証方式を”Require User Authentication”に設定した場合、詳細ページのConfigurationタブでユーザーが直接構成情報を入力または認証が必要です

詳細なユーザーエージェント使用ガイドはユーザーガイド > Agentsを参照してください。

Last updated on
使用量分析ナレッジ管理