AIエージェントの作成と管理

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

メモ:AI エージェントによる処理は、AI 通話の上限にはカウントされません。

1. このページの内容

人の介入なしに、実際の担当者のように複数のタスクを自律的に実行する新しい AI エージェントの作成方法を説明します。

先に進む前に、AI エージェントについて理解するためにこちらのヘルプページをお読みください。

2. 提供状況

AI エージェント:

Creator のすべてのプランで作成および管理できます。API 呼び出し上限は、ご契約のプランによって異なります。
スーパー管理者と管理者のみが作成および管理でき、その他の種類のユーザーはエージェントを呼び出すことができます。

3. AI エージェントの設定

新しい AI エージェントの作成は、次の 2 段階で行います。

エージェントの定義 - エージェントの目的、目標、エラー処理、全体的な動作などを指定し、エージェントのスキルの概要を数行で説明します。

例: あなたはサポート最適化担当です。案件の重大度に応じてチケットをサポート担当者や上級担当者に割り当てます。高優先度のチケットが作成されたときには、Cliq メッセージを送信します。

ツールの追加 - 上記の定義を実現するために AI が使用するツールを選択します。これらのツールは、実行すべきアクションに応じて事前に設定しておいたDeluge 関数です。

例: 「担当者を割り当てる」「Cliq メッセージを送信する」といった Deluge 関数。各ツールの目的を AI に指示できます。エージェントは、いつどのツールを使うかを自ら判断し、目標達成のために適切なツールを選択します。たとえば、高優先度のチケットが作成された場合にのみ、「Cliq メッセージを送信する」ツールを使用します。

3.1 AI エージェントを作成する手順

Creator のホームページの［DEVELOP］タブで Microservices をクリックし、右上の + Create New ボタンをクリックします。
Create New Microservice 画面に表示される AI Models カードで Create を選択します。
Build - Custom Models セクションで AI Agent カードを選択します。
Define Agent ページで、次の内容を入力します。ここではエージェントの名前と概要を設定します。

Agent Name: エージェントの名前を入力します（例: Incident Handler）。
Agent Link Name: 上記のエージェント名が自動的にリンク名に変換され、エージェントのエンドポイント URL に付加されます。必要に応じて編集できます（例: Incident_Handler）。
Instructions: エージェントの詳細な説明と、実行すべきアクションに関する指示を入力します。エージェントはここで指定した指示に従って動作します。そのため、すべてのアクションと動作を明確に列挙してください。入力後、Next をクリックします。
メモ:
1. Agent Name と Agent Link Name は最大 50 文字まで入力できます。
2. Instructions は最大 2000 文字まで入力できます。

Actions ページで、AI に必要な Deluge 関数を追加します。+ Add Tool をクリックします。
Add AI Tools ポップアップで、次の項目を選択します。

Application - 対象の Deluge 関数が存在するアプリケーションを選択します。
Namespace - 名前空間を選択すると、その配下の関数が一覧表示されます。
Function - Define Agent ページで説明したアクションを AI が実行するために必要な Deluge 関数を選択します。選択した関数に応じて、そのパラメーターが一覧表示されます。

Parameter Details - AI がパラメーターの目的と使い方を理解できるように、各パラメーターの説明に詳細を入力します。
次のように、ツールに関する情報を入力します。

Tool Name - この関数の用途がわかる名前を入力します。
Tool 説明 - ツールの用途を数行で記載します。Parameter 説明 と Tool 説明 は、いずれも AI がツールの内容を理解するために使用されます。

［Add］をクリックします。
+ Add Tool をクリックすることで、複数のツールを追加できます。追加後、Next をクリックします。

メモ: 上図のトグルを使用して、任意のツールを無効化／有効化できます。これにより、ツールの設定を保持したまま、必要に応じて柔軟に有効化できます。
Summary ページでツールの内容を確認し、Create をクリックします。エージェントのエンドポイント URL が自動生成され、表示されます。
新しいエージェントが作成され、AI Models セクションに一覧表示されます。作成した AI エージェントをクリックし、上図のように Summary ページからエンドポイント URL をコピーします。この URL を使用して、このセクションで説明している方法でエージェントにアクセスします。

3.2 指示を記述する際のベストプラクティス

AI エージェントから最適な結果を得るには、次のベストプラクティスに従って指示を記述してください。

平易な言葉を使い、明確・簡潔かつ具体的に記述します。
複雑なタスクは、小さく管理しやすいタスクに分割します。
スムーズに実行できるよう、タスクを論理的な順序で並べます。
AI エージェントがどのツールをいつ使用すべきかを明確に示します。
失敗時や想定外の状況に備えて、代替アクションを提示します。

4. AI エージェントの管理

4.1 AI エージェントの編集

Microservices に移動し、AI Models タブを開きます。
必要な AI エージェントカードの 三点リーダーアイコン をクリックし、 [Edit] を選択します。

AI エージェントビルダーが開き、リンク名以外のすべての設定を編集できます。

また、以下のようにツールを無効化／有効化することもできます。これにより、ニーズに合わせてエージェントをより細かく調整できます。
設定を変更したら、必ず [Save] をクリックしてください。クリックしない場合、行った変更はすべて失われます。

4.2 Deleting an AI Agent

Microservices に移動し、AI Models タブをクリックします。
必要な AI エージェントカードにカーソルを合わせ、横向きの三点リーダーアイコンをクリックし、削除を選択します。これによりエージェントは完全に削除されますが、関連付けられている Deluge 関数には影響しません。

4.3 エージェントログを表示する

AI エージェントの詳細ビューにアクセスするには、Microservices > AI Models に移動し、対象のエージェントカードをクリックします。

ここでは、次の項目にアクセスできます。

AIエージェントのエンドポイントURL - コピーアイコンをクリックして、エージェントURLをコピーします。
エージェントログ - このタブには、AIエージェントの実行履歴が一覧表示されます。各実行の詳細は、[サマリーを表示]をクリックして確認できます。

[Execution Summary]スライダーでは、上部にリクエストプロンプトとそのAI応答が表示されます。下部の[使用ツール]タブには、選択した実行で使用されたツールの一覧が表示されます。
AIエージェントに追加されているツールの一覧は、詳細ビュー画面の[ツール]タブをクリックすると表示できます。ここから、省略記号アイコンをクリックして任意のツールを編集または削除できます。。
AIエージェントに新しいツールを追加するには、右上の省略記号アイコンをクリックし、[編集]をクリックします。エージェントビルダーが表示されるので、そこで新しいツールを追加できます。
ステータスや実行日を条件に、必要なログだけを表示するようにフィルターできます。右側の[フィルター]をクリックし、[フィルター条件]ドロップダウンで[ステータス]または[実行日]を選択します。次のドロップダウンで条件を選択し、[フィルター]をクリックします。
実行が失敗している場合は、[サマリーを表示]をクリックして、失敗の原因を確認できます。