人への引き継ぎ

Human Handoff は、AI がそのまま返信し続けるべきではない場面で Agent の返信を止め、live user を人へ引き継ぐための設定です。

Agent が escalation の必要性を判断できても、次の返信はチームが行うべき場面で使います。

Handoff の前に応答モードを選ぶ

Agent Editor で Advanced → Response mode を開き、外部利用者からのメッセージをどのように扱うか選びます。

モード	動作	適した場面
`AI replies`	Agent は通常どおり回答し、`Human Handoff` が有効なら特定の会話だけを人へ引き継げます。	AI が承認済み範囲を処理し、例外だけ人へ渡す場合。
`Human replies only`	すべての外部メッセージを保存して人の対応を待ちます。Agent は自動返信、handoff message、handoff notification を送りません。	外部メッセージをすべて人が回答し、Codeer は会話の受信と運用に使う場合。

Human replies only は Agent 全体の運用設定であり、Agent が判断して起動する handoff ではありません。Live Test が人向け queue に変わることもありません。変更後は Apply し、新しい Agent version を公開して、実際または staging の Channel で確認してください。

使うべき場面

よい handoff rule は、たとえば次のような場面を扱います。

user が人と話したいと言っている
緊急、センシティブ、または承認済み範囲外の相談である
Agent が十分な文脈を集め、次の step が手動 follow-up である
確認質問を重ねても会話が進まない

Human Handoff を通常の routing の代わりに使わないでください。別の Agent が処理できる作業なら Call Agent を使います。follow-up 前に構造化された情報だけが必要なら Request Form を使います。

Agent Editor で設定する

Agent の Editor を開き、Human Handoff で次を設定します。

Enable human handoff: live user に対して human-only mode に入れるようにします。
Idle timeout (minutes): 任意です。設定すると、この分数だけ user が idle になった後、自動で AI mode に戻ります。空欄にすると、人が手動で AI に戻すまで human mode が続きます。
Handoff instructions: Agent がどの場面で返信を止め、人へ引き継ぐべきかを指定します。

設定を変更したら、Apply で新しい version として保存します。handoff path を確認してから、その version を公開してください。

Handoff が使える場所

Handoff tool は、Codeer が external user を識別できる live end-user conversation でのみ有効です。Editor 内の Live Test とは別物です。

Handoff 時にチームへ通知する

Agent Editor の Handoff notifications には、この Agent の現在の通知モードと実効通知先が読み取り専用で表示されます。ここでは通知先を作成、編集、削除できません。

ワークスペース通知を管理 を選ぶと、ワークスペース通知の Agent の引き継ぎ イベントと対象 Agent が開きます。個別設定のない Agent はワークスペースルールを自動的に使用します。次の例外が必要な場合にのみ個別設定を追加します。

カスタム通知先: この Agent 用に既存かつ互換性のある通知先を選びます。
通知なし: この Agent が handoff してもチームへ通知しません。

既存の設定を 通知なし に変更すると、それまで選択していたカスタム通知先は解除されます。後でカスタム通知を再開する場合は、個別設定を編集して通知先を選び直してください。

個別設定を削除すると、Agent はワークスペースルールを使用します。削除した設定が 通知なし だった場合、ワークスペースルールが利用可能であれば通知が再開されます。カスタム通知先 は、この Agent が使う既存の通知先だけを変更します。通知先を追加、編集、テスト、確認、有効化、無効化、削除する場合は、ワークスペース通知の 通知先 タブを使います。

実効通知先の概要には、無効、未確認、または互換性のない通知先は含まれません。ワークスペースルールが未作成、無効、または利用可能な通知先がない場合、デフォルトを使う Agent から通知は送信されません。ワークスペースルールが利用可能になると配信を再開します。

Webhook URL は秘密として扱う

Slack webhook URL は secret です。作成と管理はワークスペース通知でのみ行い、公開ドキュメント、issue comment、スクリーンショット、source code には貼らないでください。

引き継ぎ指示は狭く書く

Agent がいつ止まって人へ渡すべきかを明確に書きます。「必要な時に handoff する」のような広すぎる rule は避けてください。

例：

Request human handoff when the user asks for a person, reports an urgent billing or safety concern, or has already answered the qualification questions and wants a callback. Before handing off, summarize the reason in one sentence and do not continue troubleshooting.

User には何が起きるか

Agent が handoff を起動すると、platform はこの会話を人の teammate に引き継いだことを短く user に伝えます。その後、同じ user と同じ Agent については、Agent は AI 返信を生成しません。

Human-only mode が有効な間:

user の新しい message は conversation history に保存される
Agent はそれらの message に返信しない
file attachment は記録された user turn に紐づく
idle timeout がある場合、新しい message ごとに timeout window が延長される

Timeout が切れると、次の user message は再び AI が処理できます。Timeout を設定していない場合は、operator が手動で AI mode に戻します。

顧客ページから引き継ぎを管理する

ユーザーが Agent とやり取りした後、顧客からそのユーザーを開きます。ユーザー詳細ページでは、現在の対応モード、変更理由、有人モードの期限を確認できます。

編集権限のある operator は次の操作ができます。

Agent interaction を AI から Human に切り替える
active な human interaction を AI に戻す
現在の human mode が Agent 起点、CRM の手動変更、自動 timeout のどれによるものか確認する

手動で Human に切り替えられるのは、その Agent が公開済みで、handoff が有効な場合だけです。

公開前に確認する

Human Handoff は end-user identity に依存するため、可能なら実際の channel または staging experience で確認します。次を確認してください。

設定した条件で Agent が handoff する
handoff message が明確である
その後の user message は記録されるが、AI は返信しない
timeout 後に AI へ戻る、または手動で AI に戻せる