ガイド作成のベストプラクティス

AI エージェントのインタラクションは非決定論的です。つまり、同じガイドを使用している場合でも、異なるセッション間で同じクエリに対して異なる応答をする可能性があります。しかし、ベストプラクティスに従うことで、彼らの行動を形作り、一貫性を向上させることができます。ガイドの指示を書く。

ガイドを計画する

ガイドを計画するときは、目標を守り、ガイドが長くなりすぎないように注意してください。

ガイドを単一のタスクに集中させる

各ガイドは、「配送日の変更」や「口座残高の確認」など、明確に定義された単一の顧客意図に対応するように設計することをお勧めします。各ガイドを 1 つの目的に限定すると、LLM の範囲が狭まり、予測可能性と正確性が確保されます。複数のインテントが関係する会話の場合は、単一の Architect フロー内で複数のガイドブロックを接続します。

ガイドは短くする

成功するガイドを構築するには、まず重要な手順から開始し、実際のユーザーとデータで検証し、徐々に機能を拡張して目的の結果を達成します。適切な基盤と反復的なアプローチにより、AI エージェントは、タスクだけでなく、インテリジェンスと適応性を備えたワークフロー全体を自動化することで、真のビジネス価値を提供できます。

プロフェッショナルで会話的な口調を維持する

ガイドの指示は技術的なものであっても、結果として得られる AI エージェントのやり取りは自然なものになるはずです。プロフェッショナルで役立つ、会話的な口調になるように指示を言い表してください。

ガイドを作成する

シンプルで管理しやすいタスクを構造化、フォーマット、作成するには、次のガイドラインに従ってください。

ガイドの構成とフォーマット

最初のステップに手動で番号を付けます。Enter キーを押すと、エディターは番号付けを続行します。
インデントを使用して階層の形式を表すことで、AI エージェントが構造を適切に解釈できるようになります。
AI エージェントに特定のフレーズやメッセージを言わせたい場合は引用符を使用します。たとえば、「ルーターのステータスライトについて説明していただけますか?」
ガイドに含まれる単位や通貨があればそれを記載します。たとえば、「すべての製品の値はユーロで表されています € 」などです。
日付には特定の形式を使用します。たとえば、「dd/mm/yyyy」。

タスクを簡単なステップに分解する

複雑なタスクを、より単純で管理しやすいステップに分割します。このプロセスにより、仮想エージェントは圧倒されることなく指示に正確に従うことができます。

AI エージェントにタスクを実行させたい順序で各ステップに番号を付けます。ステップに番号を付けることによって、AI エージェントに順次実行を中断してガイド内の任意のステップにジャンプするように指示することもできます。
追加の対策として、ガイドをメインステップとサブステップに分けます。このアプローチを使用すると、メインステップに一意の名前を割り当てることができ、AI エージェントが必要に応じて任意のメインステップにジャンプできるようになります。

例を見せてください

1. Basic checks
   ...
2. AB Refund
   ...
3. Refund
   ...
4. Troubleshooting
  - If customer has a model type A or B:
    - Go to: [AB Refund]
  - else if customer has any other type:
    - Go to: [Refund]

各ステップの最後に顧客のアクションまたはプロンプトをトリガーする

ガイドのすべてのステップで AI エージェントが顧客のアクションまたは応答を予測できるようにします。
現在のステップにそのようなクエリがない場合は、顧客の返信を必要とする次のステップと組み合わせます。
顧客からの返信を期待せずに、AI エージェントに複数のメッセージを連続して伝えたい場合は、単一のメッセージを使用します。

例を見せてください

良い例	悪い例
顧客の注文とメール情報を収集する – エージェントが顧客に{{Variable.orderID}}を尋ねます – 顧客は{{Variable.orderID}}を提供します – エージェントが顧客に{{Variable.email}}を尋ねます – 顧客は{{Variable.email}}を提供します – {{Variable.orderID}} と {{Variable.email}} を使用して {{Action.getOrderStatus}} を呼び出します	顧客の注文とメール情報を収集する – エージェントが顧客に{{Variable.orderID}}を尋ねます – エージェントが顧客に{{Variable.email}}を尋ねます – {{Variable.orderID}} と {{Variable.email}} を使用して {{Action.getOrderStatus}} を呼び出します

ステップ間を移動するには角括弧を使用します

角括弧を使用して他の手順を参照します。
目的地までのステップを明確に述べます。

例を見せてください

良い例	悪い例
[患者情報の収集]ステップに進みます。	手順2に進みます。

曖昧さを減らす

ステップを定義するときは、AI エージェントに期待する結果または応答を正確かつ具体的に指定します。
あいまい、漠然とした、または広範な指示の使用は控えてください。明確な指示は、AI エージェントがより良い結果を生み出すのに役立ちます。
変数、データアクション、さまざまなシナリオの処理に関する具体的なガイダンスを含めることで、可能な限り多くのコンテキストを提供します。緊急時対応計画を使用して、予期しないシナリオに対処できるようにエージェントを設定します。たとえば、ユーザーが「わかりません」と言った場合、エージェントはユーザーの不確実性を認識し、「申し訳ありませんが、ご質問にはお答えできません」と応答する必要があります。「人間のエージェントに接続しますか？」このような予期しないシナリオに対処するために、メインステップの下にサブステップを追加できます。

プレビューと反復

ガイドを Architect ボットフローに接続してテストし、AI エージェントのパフォーマンスに満足するまで指示を調整します。詳細については、テストとトラブルシューティングガイド。