AI エージェントでチャットボット コンポーネントを使用する

このページでは、コンポーネントをAIエージェントのツールとして使用する方法と、それらを構成するためのベストプラクティスについて説明します。

チャットボットのコンポーネント

コンポーネントは、情報の取得、FAQ への回答、アクションの実行などのタスクを実行する再利用可能なブロックです。

例: 予約の空き状況の確認、予約の実行、またはエンド ユーザー情報の取得。

コンポーネントは、AI エージェントの ツール として追加できます。また、ナレッジ エージェントと統合してナレッジ ベースをクエリし、検索拡張生成 (RAG) を有効にすることもできます。

機能、利点、設定手順は、 チャットボットコンポーネントドキュメント をご参照ください。

AI エージェントでコンポーネントが使用される理由

コンポーネントを使用すると、エージェントが行う必要があるツール呼び出しの数が減り、パフォーマンスと信頼性が向上します。

コンポーネントは、単一の API 呼び出しに限定されません。

次のことができます。

• 複雑なロジックの管理: コンポーネントには複数のダイアログがあり、複雑な条件付きロジックを管理できます。
• API結果の処理: API結果を解釈するためにLLM主導の洞察が必要な場合は、API呼び出しの後にカスタムプロンプトエレメントを追加して、データを処理し、AIエージェントに意味のある情報を返すことができます。
• 複数の操作の順序付け: 連続した API 呼び出しを 1 つのコンポーネントにグループ化して、応答時間を最小限に抑え、エージェントの意思決定を簡素化します。

AI エージェントでコンポーネントを使用する

コンポーネントには、LLM に「いつ」、どのように使用するかを指示する明確な説明が必要です。

コンポーネントで使用される components および input attributes のベスト プラクティス セクションを参照してください。

コンポーネントとナレッジベースの統合

コンポーネントはナレッジエージェントと統合して、ナレッジベースにアクセスできます。これにより、AI エージェントは検索拡張生成 (RAG) を使用して会社固有のドキュメントを取得できます。

仕組み

1. ナレッジエージェントの作成 および ナレッジ ソースの接続。例: ドキュメント、FAQ、サポート記事。
2. チャットボットでコンポーネントを作成します。
3. AIアシスタントエレメントをコンポーネントに追加します。
4. コンポーネントを AI エージェントのツールとして構成します。

AI エージェントがこのコンポーネントを呼び出すと、ナレッジ ベースにクエリを実行し、エンド ユーザーの質問に答えるための関連情報を返します。

詳細な設定手順については、ナレッジエージェントのドキュメントを参照してください。

コンポーネント記述のベストプラクティス

AI エージェントのツールとして使用するコンポーネントを作成するときは、LLM にこのツールをいつ使用するか、また何をするかを伝える明確な説明を提供する必要があります。説明は、使用可能なアクションのエージェントリストにおけるツールの役割を定義します。

コンポーネントの説明を使用する理由

この説明は、次の点に役立ちます。

• これは、LLM がこのコンポーネントがエンドユーザーの要求に対して正しい選択であるかどうかを判断するのに役立ちます。
• この情報がないと、エージェントはこのコンポーネントをいつ呼び出すべきかわからなかったり、間違ったコンポーネントを選択したりする可能性があります。
• これにより、正しい意図の認識が保証され、類似したコンポーネント間の混乱が軽減されます。

コンポーネント記述のベストプラクティス

1. Start with a Clear Purpose: 例: このツールを使用して、エンドユーザーがお金を使うことに言及したときに新しい経費を記録します。
2. 一般的なユースケース/ユーザーの意図を説明してください: 例: エンドユーザーが「今日の昼食に 20 米ドルを追加してください」または「昨日家賃を支払いました」などと言ったときに、このツールを呼び出します。
3. キー入力の指定: 例: *このツールは、金額、カテゴリ、日付、および説明を受け取ります。
4. 出力目的の説明: 例: *経費が追加された後に確認メッセージを返します。
5. 明確で短い文章を使用する: 1〜2の簡潔な段落を使用します。

コンポーネントの説明例

Use this tool to record a new expense. Call it when the end user mentions paying for something, such as "Add 30 dollars for groceries today."
 
Takes amount, category, date, and description as inputs, and returns a confirmation message after the expense is recorded.

入力属性の説明

コンポーネントは、入力属性を介して入力を受け取ります。これらの属性について明確な説明を提供し、そのフィールドに入力する必要がある情報をLLMに伝えることが重要です。形式と意味を説明し、期待される内容の例を示します。

入力属性の説明を使用する理由

• モデルは、このテキストを使用して、エンドユーザーのメッセージから何を抽出するかを認識します。
• 日付、通貨、テキスト形式の誤りなどの書式設定エラーを防ぎます。
• 毎回同じ種類のデータを同じフィールドにマッピングすることで、一貫性を確保します。

ベストプラクティス

1. 属性が表すものからStart: 例: *経費が発生した日付。
2. 必要な形式または単位を説明してください: 例: *DD-MM-YYYY 形式を使用します。「今日」または「昨日」を実際の日付に変換します。
3. 例を追加: 例: 例: 15-09-2025.
4. あいまいな入力を管理する方法を指定する: 例: *エンドユーザーがカテゴリを指定しない場合は、それを「その他」にマッピングします。
5. 簡潔かつ具体的に: 各属性に最大 3 行を使用します。

入力属性の説明の例

The date when the expense occurred. Use DD-MM-YYYY format.
Example: "12-10-2025". Convert natural language inputs ("today", "yesterday") into actual dates.

入力属性の入力書式フィールド

入力形式 フィールドは、ツールの実行前に入力データを検証します。これにより、各入力が特定の構造または形式に従うことが保証されます。例: 有効な日付、数値、またはキーワード。

検証では、入力として許可されるものと許可されないものを記述するテキスト パターンである 正規表現 (regex) を使用します。

入力形式を検証する理由

検証を行わないと、エージェントは次の 1 つ以上を実行する可能性があります。

• 誤ったデータを送信します。例: 20 という数字の代わりに 20 ドルをテキストとして書きます。
• 必要なすべての入力を行わずに、または一部の情報のみを使用してツールを呼び出してみてください。
• 一貫性のない形式を使用します。例: 2025 年 3 月 11 日ではなく 2025 年 11 月 3 日。
• 入力の形式が間違っているか、予期しない値が含まれている場合、ツールが失敗します。

正規表現の検証は、ツールの実行前に入力をチェックすることで、これらの問題を防ぎます。入力が許可された形式と一致しない場合、エージェントは入力が修正されるまでツールを実行できません。

正規表現の検証の仕組み

各入力属性には、有効な入力がどのように表示されるかを記述する正規表現パターンを定義する独自の 入力形式 フィールドを含めることができます。

AI エージェントがエンドユーザーのメッセージから値を抽出してツールに送信すると、次のことが起こります。

• 値が正規表現パターンと一致する場合、ツールが実行されます。
• 値がパターンと一致しない場合、システムは明確化を求めるか、実行を停止します。

正規表現パターンを作成してテストする方法

オンライン正規表現テスターを使用して、次の操作を実行できます。

• パターンをインタラクティブに作成およびテストします。
• 各正規表現部分の説明を取得します。
• 期待したもののみと一致することを確認します。

入力形式検証の使用例