自由形式の手順

概要

自由形式のプロシージャは、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件の異なるプロシージャを識別して、それぞれに生成された名前、トリガー、コンテンツを含む下書きを作成します。各下書きを開いて調整してください。ドキュメントに11件以上のSOPが含まれている場合は、アップロード前に小さなファイルに分割してください。

自由形式のプロシージャを管理する

ベストプラクティス

優れたプロシージャを作成するには、2つの部分を適切に記述する必要があります。適切なタイミングでプロシージャを実行するトリガーと、エージェントが従えるコンテンツです。

トリガーを書く

コンテンツを書く

プロシージャを組み合わせる