自由形式の手順

概要

自由形式の手順は、1つのタスクを平易な自然言語で説明します。エージェントは指示を解釈し、状況に応じて表現や順序を調整します。自由形式の手順では、ツール（通話終了などのシステムツールを含む）の呼び出し、ナレッジベースのドキュメントの検索、他の手順への連鎖ができます。

自由形式の手順を使う場面

エージェントが状況に合わせて表現や順序を調整でき、自然言語で素早く作成したい場合は、自由形式の手順を使用します。構造化された手順、ワークフロー、システムプロンプトとの比較については、手順を使う場面を参照してください。

手順の構成

エディターでの返金手順の例です。

手順は、トリガーとコンテンツという2つの主要部分で構成されます。どちらにも他のリソースへのインライン参照を含められます。上のスクリーンショットでは、レンチアイコン付きのタグとして表示されています。各手順には、ダッシュボードに表示される名前もあります。

名前

ダッシュボードで手順を識別するための短いラベルです。名前がLLMに送信されることはないため、エージェントの動作には影響しません。

トリガー

エージェントがこの手順を使用するタイミングの説明です。例：ユーザーが注文の返金を求めた場合。

トリガーを空にするのは、サブ手順を作成する場合だけです。

コンテンツ

Markdownで記述する手順の本文です。コンテンツには、質問する、注文を検索する、ツールを呼び出す、通話を終了するなど、エージェントが行うことを記述します。順に実行する番号付きのステップにすることも、状況に応じた一般的なガイダンスにすることもできます。各ステップやガイドラインは、1文（ユーザーに注文IDを尋ねる）でも、何をするのかとその理由を説明する短い段落でもかまいません。

順番に行うアクションには番号付きステップを、ステップ内の要件や下位項目には箇条書きを使用します。

インライン参照

手順では、さまざまな種類のリソースをインラインで参照できます。

• ツール（例：注文の検索、カードへの請求、通話の終了、担当者への転送）
• ナレッジベースのドキュメント
• 他の手順

ステップでエージェントがツール、ナレッジベースのドキュメント、または別の手順を使用する必要がある場合は、必ずインライン参照を使用します。参照によりリソースが手順に自動で追加され、エージェントが使用できるようになります。_ここで計算ツールを使用する_のように通常の文章で言及することもできますが、リソースがすでにエージェントに追加されている場合に限ります。

トリガーまたはコンテンツで/を入力し、スラッシュメニューからリソースを選択して参照を挿入します。参照はエディター内でクリック可能なタグとして表示されます。タグをクリックすると、元のリソースを開いて設定を確認できます。

APIを通じて自由形式のコンテンツを記述する場合は、次の構文で参照を挿入します。

[tool id="tool_abc123"]
[kb id="kb_abc123"]
[procedure id="agtprc_abc123"]
[system_tool id="end_call"]
{{customer_id}}

インラインの手順参照には、同じエージェントの手順を使用する必要があります。エージェントのスコープと複製時の動作については、制限事項を参照してください。

トリガー内の参照により、リソースの出力に基づいて手順を開始できます。たとえば、_get_userがtier ‘gold’を返した場合_です。コンテンツ内の参照は、そのステップでリソースを呼び出す、または参照するようエージェントに指示します。

参照先のリソースが後で削除された場合、またはアカウントがそのリソースへのアクセス権を失った場合、タグは壊れた状態で表示されます。エディター上部のエラーバッジには、これらの参照が一覧表示されます。リソースが存在しない場合は_無効_、存在するもののアカウントにアクセス権がない場合は_利用不可_と表示されます。バッジを開くと影響を受けるステップを確認でき、参照を修正または削除できます。

サブ手順

サブ手順のトリガーは空です。参照している別の手順からのみ実行できます。

サブ手順を使用すると、1つのエージェント内でステップを共有でき、同時に利用可能な手順の数を減らせます。エントリー手順にはトリガーを設定し、そのコンテンツから関連するサブ手順を参照し、サブ手順のトリガーは空のままにします。

エスカレーション用のサブ手順には、会話を担当者へ引き継ぐステップを含めることができます。返金およびキャンセルの手順からこれを参照し、トリガーは空のままにします。エージェントはどちらの手順でもステップの一部としてエスカレーションできますが、それら以外ではサブ手順を利用できません。

ドキュメントからのインポート

既存の標準作業手順書（SOP）をもとに作成を始められます。手順一覧の + メニューでSOPからを選択し、ファイルをアップロードします。

対応形式：PDF、DOCX、TXT、MD、HTML、EPUB。ファイルは20MB以下である必要があります。

インポーターはドキュメントを分析し、最大10件の個別手順を識別して、それぞれに生成された名前、トリガー、コンテンツを含む下書きを作成します。各下書きを開いて調整してください。ドキュメントにSOPが10件を超えて含まれている場合は、アップロードする前に小さなファイルに分割してください。

自由形式の手順を管理する

ベストプラクティス

手順を適切に記述するとは、必要なときに手順を実行するトリガーと、エージェントが従えるコンテンツの2つを適切に記述することです。

手順の反復改善

小さく始め、エージェントテストで各変更を確認してから次の変更に進むことをおすすめします。

1. トリガーと短いコンテンツを記述します。
2. 手順を開始すべきリクエストと、似ているが開始すべきでないリクエストに対するシミュレーションテストを作成します。
3. 手順全体を実行するシミュレーションテストを作成します。
4. テストを実行します。失敗した場合は、トリガーまたはコンテンツを修正します。
5. 変更のたびにテストを再実行します。

テストや実際の会話が失敗した場合は、手順を変更する前に過去の会話から類似した失敗を検索し、それらすべてに対応する1つの指示を記述します。原因はナレッジベースやエージェント設定にある場合もあります。Architectでこの検索を実行できます。失敗した会話を開き、Architectを選択して、類似した失敗を探して修正案を提示するよう依頼してください。Architectでは会話をテストに変換することもできます。

トリガーの記述

コンテンツの記述

手順の組み合わせ