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

エージェント管理

インストール済みのエージェントを確認し、有効・無効を切り替えられます。AI担当者は、作成・設定変更・削除もできます。会話とエクスポートは、CLIのバージョンとサーバーで許可されている場合に利用できます。

一覧と詳細を確認する

aipctl agent list aipctl agent get AGENT_ID aipctl agent get AGENT_ID --json

一覧からIDを選び、名前・説明・必要な連携を確認します。これらは設定を確認するコマンドであり、エージェントに質問を送るものではありません。

エージェントを作成する

以下をagent.jsonとして保存してください。名前と説明を持つカスタムエージェントを作成する基本例です。

{ "agentType": "CUSTOM", "custom": { "displayName": "週次レポートアシスタント", "shortDescription": "週次の業務レポートを整理します。" } }
aipctl admin agent create ./agent.json aipctl agent list

返されたIDでエージェントを確認し、モデルや指示など、必要な設定を完了してください。作成しただけでは、すべての設定や有効化が完了するわけではありません。

設定を変更する

カスタムエージェントの名前と説明を変更する例です。以下をagent-update.jsonとして保存してください。

{ "agentType": "CUSTOM", "custom": { "displayName": "チーム週次レポートアシスタント", "shortDescription": "チームの週次業務を整理します。" } }
aipctl admin agent update AGENT_ID ./agent-update.json aipctl agent get AGENT_ID

エージェントの種類に合う設定を使用してください。詳細の取得結果全体を、そのまま更新リクエストに渡す方法には対応していません。

カスタムエージェントのモデルと指示も変更できます。aipctl model listで利用できるモデルIDを確認し、次の設定を作成します。

{ "agentType": "CUSTOM", "custom": { "modelName": "MODEL_ID", "instruction": "週次業務を、完了した作業、進行中の作業、次の予定に分けて整理してください。" } }

MODEL_IDを、その組織で利用できる実際のモデルIDに置き換えてください。別のJSONファイルに保存し、同じadmin agent updateコマンドで適用してから、詳細を再確認します。モデルや指示の変更は、その後の応答に影響します。

カスタムエージェントの主な更新フィールドは次のとおりです。

フィールド用途
displayName表示名
shortDescription, description短い説明と詳細な説明
modelName利用するモデルID
instructionエージェントの動作指示
expectedInstruction現在の指示が想定した値と一致する場合にだけ更新するための値。同時編集で競合した場合は、最新の内容を再取得します。
knowledgeBundleIdList接続するナレッジバンドルIDの配列。対象ナレッジへのアクセス権限が必要です。

これらはカスタムエージェント用のフィールドです。ビルトインエージェントに同じ設定を適用できるとは限りません。

有効状態と共有設定を確認する

aipctl agent disable AGENT_ID aipctl agent enable AGENT_ID aipctl admin agent share AGENT_ID aipctl admin agent templates
  • disable・enable:有効・無効を切り替えます。組織の有効化ポリシーと権限が適用されます。
  • share:現在の共有設定を確認します。共有先を変更するコマンドではありません。
  • templates:作成時に参考にできるテンプレート一覧を取得します。

エージェントを削除する

aipctl agent get AGENT_ID aipctl agent disable AGENT_ID aipctl admin agent delete AGENT_ID --force

自動化など、他の処理で使っているエージェントでないか確認してください。使用中という案内が表示された場合は、関連する処理を先に整理します。

エージェントと会話する

利用するエージェントのIDと実行権限が必要です。会話の実行が制限されている環境では、ウェブを利用してください。

新しい会話では、インストール済みのエージェントIDを指定します。

aipctl agent chat --agentId AGENT_ID --message "今週の業務を整理してください。" --json

--messageは-mでも指定できます。JSON結果のconversationIdを保存すると、同じ会話を続けられます。

aipctl agent chat --conversation-id CONVERSATION_ID -m "優先順位も付けてください。" --json

ファイルのテキストを標準入力で渡す例です。

aipctl agent chat --agentId AGENT_ID --json < ./question.txt

--messageを指定すると、標準入力より優先されます。リクエストを送るとエージェントが実行され、使用量が発生する場合があります。タイムアウトや接続中断が起きたときは、同じ質問をすぐに再送せず、ウェブや会話取得コマンドで結果を確認してください。コマンドがない場合や実行が拒否される場合は、ウェブで会話してください。

YAMLでエクスポートする

エクスポート権限を確認してから実行してください。

aipctl admin agent export AGENT_ID --output ./exports/agent.yaml

--outputは-oでも指定できます。省略すると現在のフォルダーにAGENT_ID.yamlとして保存され、同じパスのファイルは上書きされます。成功メッセージの保存先を確認してください。設定には業務上の指示などが含まれる場合があるため、共有範囲を確認します。拒否された場合は、権限とサーバーの提供範囲を確認してください。

Last updated on