エージェント管理
インストール済みのエージェントを確認し、有効・無効を切り替えられます。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 templatesdisable・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として保存され、同じパスのファイルは上書きされます。成功メッセージの保存先を確認してください。設定には業務上の指示などが含まれる場合があるため、共有範囲を確認します。拒否された場合は、権限とサーバーの提供範囲を確認してください。