新しいステップをFin Procedureに追加する際、指示ステップがデフォルトのステップです。指示ステップは最も強力で、Finが自然言語で実行する一貫した作業単位を定義できます。
指示ステップの機能
指示ステップを実行する際、デフォルトでFinは以下のツールにアクセスできます：
指示ステップ内でこれらのツールを使うには、単に@を入力して検索メニューを開きます。
カテゴリ | ツール | 説明 |
ロジック＆フロー制御 | @Condition | 分岐ロジック（IF / ELSE）を追加します。 |
| @Run sub-procedure | 共通のフローを再利用したり、メインフローから隠したい複雑なフローを使えます。 |
| @Create sub-procedure | 現在のエディターから直接新しいネストフローを作成します。 |
データ操作 | @Read attribute | Finに特定のIntercomデータを手続きコンテキストに取り込むよう指示します。これにはPeopleの詳細（名前など）、Company情報、Conversationの状態（添付ファイルなど）、またはTemporaryカスタム属性が含まれます。例：@read nameでユーザー名で挨拶します。 |
| @Update attribute | Finに任意のintercom属性を@updateするよう指示できます。
注意：Finは匿名のleadsで既存のメールや電話がないPeopleのメール属性のみを更新でき、これはIntercomチームによる機能フラグが有効な場合に限ります。それ以外の場合、連絡先情報保護のため更新要求は拒否されます。 |
| @Create attribute | 必要な属性がまだ存在しない場合は、その場で新しい属性を作成します。 |
知識＆コンテキスト | @Look up content | FinにHelp Centerや外部knowledge baseから特定情報を検索させます。@Look up contentの詳細はこちら。 |
| @Use data connector (Call an API endpoint) | @use data connectorするとFinはそのAPIエンドポイントにアクセスします。ステップごとにデータコネクタは1つまでに最適化してください。 |
| @Create data connector | 現在のエディターから直接新しいネストフローを作成します。 |
ルーティング＆終了 | @End | 手続きを即座に終了し、Finに戻します。 |
| @Handoff to team | 会話をチームまたはチームメイトに引き継ぎます。 |
| @Handoff to Workflow | 手続きを終了し、ユーザーをWorkflowに渡します。 |
| @Switch procedure | 現在の手続きを終了し、別の手続きを即座に開始します。これは一方向の遷移です。Finは現在のProcedureを離れ新しいProcedureに入りますが、新しいProcedure終了後に元のProcedureに戻りません。@SwitchはProcedureの引き継ぎとはみなされず、解決状態も変更しません。解決済みやProcedure引き継ぎ結果としては記録されません。 |
会話アクション | @Add note | inboxのチームメイト向けのメモとして表示される事前定義メッセージを追加します。 |
| @Tag | Finが会話に動的にタグを適用できるようにします。 |
注意：
一般的に、“@”で機能を呼び出せない場合はサポートされていません。例えば、Finはメール送信、電話発信、タグ削除はできません。
「別のprocedureに移動」「メモを追加」「顧客のOTPを確認」などの自然言語コマンドは避け、サポートされているツールを使いましょう。
ベストプラクティス
指示を書く際の2つの基本設計原則があります。
1つの指示ステップは意味のある作業単位を表すべきです。
関連するアクションを一貫して組み合わせた、よく設計された少数のステップが、多数の小さなステップより優れています。同時にステップは大きすぎないように：目安としてステップ内のデータコネクタ呼び出しは1回までにし、更新属性やタグの数はFinが速く実行できるよう必要最低限に減らしましょう。
❌ 効果の低い例：
Step 1 - @read Email.
Step 2 - Ask for email if it's not there.
Step 3 - @use get_subscription_details
Step 4 - Send a reply listing every API field.
✅ より効果的で構造化された例：
@read email. If it is not known, ask the user for their email before continuing. Then @use get_subscription_details and reply asking the user what they need help with. Include the user's current plan, plan status, and next renewal date in your reply.
シンプルで明確に保つ
常にシンプルで明確に保つよう最適化し、Finが混乱せず指示に従えるようにしましょう。文脈のない人間が理解できなければ、Finも理解できません。
平易で具体的な動詞を使いましょう。日常的な動作動詞（尋ねる、確認する、送る、更新する、エスカレートする）でステップを書き、抽象的・形式的な動詞（検証する、確かめる、実行する、促進する）は避けましょう。
❌ 効果の低い例 - 注文番号や追跡番号が何か不明確：
Collect the customers order number: Collect the customers order number and make sure it is valid and not a tracking number.
✅ よく構造化されたステップ - 注文番号の形状と、顧客が提供できない場合の対応をFinに伝えます：
Collect the customers order number:
If they provided a number but it is longer than 11 characters excluding the # at the start of the number, then let them know that it may be a tracking number and ask them for the order number again.
If the customer can not provide their order number do not continue @Escalate:Support team