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

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

1. このページの内容

独立して動作し、人間の介入なしで本物のエージェントのように複数のタスクを実行する新規AIエージェントの作成方法について説明します。

続行する前に、AIエージェントについて理解するためにこちらのヘルプページをご覧ください。

2. 利用可能範囲

AIエージェント:

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

3. AIエージェントのセットアップ

新規AIエージェントの作成は、以下の2つのステップで進めます。

エージェントの定義 - エージェントのスキルに関する目的、目標、エラー処理、完了時の動作を簡潔に記載します。

例：あなたはサポート最適化担当者です。ケースの重大度に応じて、チケットをシニアのサポート担当者に割り当てます。高優先度のチケットが発生した際にはCliqメッセージを送信します。

ツールの追加 - 上記で定義した内容に基づき、AIが使用するツールのリストを選択します。これらのツールは、必要な処理に応じて事前に設定したDeluge関数です。

例：Assign executivesやCliqメッセージ送信などのDeluge関数。各ツールの用途をAIに指示できます。エージェントはツールの使用タイミングを判断し、適切なツールを選択して目標を達成します。例えば、高優先度のチケットが発生した場合のみ、Cliqメッセージ送信ツールを使用します。

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

CreatorのホームページのDEVELOPタブからMicroservicesをクリックし、右上の+ 新しく作成するボタンをクリックします。
新しく作成する Microservice画面に表示されるAI Modelsカードで作成を選択します。
作成 - カスタム ModelsセクションのAI Agentカードを選択します。
Define Agentページで以下の詳細を入力します。ここではエージェントの名前と説明を設定します。

Agent 名前: エージェント名を入力します。例：Incident Handler
Agent リンク名前: 上記で入力したエージェント名が自動的にリンク名に変換され、エージェントのエンドポイントURLに追加されます。必要に応じて編集も可能です。例：Incident_Handler
Instructions: エージェントの詳細説明と、実行すべき処理の手順を入力します。エージェントはここで指定した指示に従って動作します。処理内容や動作をわかりやすくすべて記載してください。次へをクリックします。
メモ:
1. Agent 名前およびAgent リンク名前は50文字まで入力可能です。
2. Instructionsは2000文字まで入力できます。

処理ページで、AIが必要とするDeluge関数を追加します。+ 追加する Toolをクリックします。
追加する AI Toolsのポップアップで、以下の詳細を選択します。

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

Parameter 詳細 - 説明欄に各パラメーターの詳細を追加し、AIがその目的や使い方を理解できるようにします。
ツールの詳細を以下のように入力します:

Tool 名前 - この関数のわかりやすい名前を入力してください。
Tool 説明 - ツールの用途を数行で記載します。Parameter 説明とTool 説明の両方がAIによるツールの理解時に使用されます。

クリック 追加する。
+ 追加する Toolをクリックして、複数のツールを追加できます。次をクリックします。

メモ: 上記のトグルを使用して、任意のツールを無効化または有効化できます。これにより、ツールの設定を保持したまま、必要に応じて有効化する柔軟性が得られます。
ツールを概要ページで認証し、作成をクリックします。エージェントのエンドポイントURLが自動的に生成され、表示されます。
新規エージェントが作成され、AI Modelsセクションに一覧表示されます。新しく作成したAIエージェントをクリックし、上記画像のように概要ページからエンドポイントURLをコピーします。このURLを該当セクションの説明に従ってエージェントへのアクセスに使用します。

3.2 指示を与える際のベストプラクティス

AIエージェントから最適な結果を得るために、指示を出す際は以下のベストプラクティスに従うことが推奨されます。

シンプルな言葉を使用し、明確・簡潔かつ具体的に伝えましょう。
複雑なタスクは、より小さく管理しやすいタスクに分割します。
タスクを論理的な順序で並べ、スムーズに実行できるようにします。
AIエージェントがどのツールをいつ使用すべきか、明確に示します。
失敗や予期しない状況に備えて、代替の処理方法も提示しましょう。

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

4.1 AIエージェントの編集

Microservicesに移動し、AI Modelsタブを開きます。
ellipsisアイコンをクリックします。必須AIエージェントカード上で「編集」を選択します。

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

注：AIスキルの無効化や有効化も可能です。下記のツールを利用できます。これにより、エージェントをニーズに合わせてさらに最適化できます。
設定に必要な変更を加えた後、「保存」をクリックしてください。保存しない場合、変更内容は失われます。

4.2 AIエージェントの削除

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

4.3 エージェントログの表示

AIエージェントの詳細な表示にアクセスするには、Microservices > AI Modelsに移動し、該当のエージェントカードをクリックしてください。

ここで、次の操作が可能です。

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

Execution 概要スライダーの上部にはリクエストプロンプトとAIの応答が表示されます。下部のTools 使用中タブには、選択した実行で使用されたツールの一覧が表示されます。
AIエージェントに追加されたツール一覧は、詳細表示ページのToolsタブをクリックすると確認できます。ここで三点アイコンをクリックしてツールの編集や削除が可能です。。
AIエージェントに新しいツールを追加する場合は、右上の三点アイコンをクリックし、編集を選択します。エージェントビルダーが表示され、そこで新規ツールの追加が可能です。
ログをステータスや実行日で絞り込んで、必要なものだけを表示できます。画面右側のフィルターをクリックし、フィルター条件ドロップダウンでステータスまたはExecuted オンを選択します。次のドロップダウンで条件を指定し、フィルターをクリックしてください。
実行で失敗が発生した場合は、表示する概要をクリックすると失敗の原因を確認できます。