決済

決済 を使うと、承認済みの Agent フローを会話の中から実際のチェックアウトへ渡し、その結果を同じ会話に戻せます。

これは、支払い完了後にだけ次のステップへ進めたい場面に向いています。たとえば相談料、予約金、その他の承認済みサービス料金です。

決済を使うべき場面

次の条件がそろっているときに 決済 を使います。

決済で新しい提案を即興で作らない

決済ステップは、すでに承認された料金を回収するためのものです。Agent がその場で新しい価格、プラン、保証を作る場所ではありません。

決済 をうまく使うには、先に次の二つを整えます。

どちらかが欠けている場合は、実ユーザー向けのテストに進む前に設定を整えてください。

決済アカウントは workspace ごとに設定します。

Payments タブにある Newebpay の workspace 決済設定

複数の workspace を運用している場合は、それぞれ別に設定して、正しい Agent が正しい決済アカウントを使うようにします。

workspace の決済設定が終わったら、次は Agent 側です。

Tool picker で Payment tool を選ぶ画面

Payment tool の When to Use テスト設定例

よい指示は、たとえば次のような形です。

ユーザーが承認済みのサービス内容と料金を確認し、支払い完了後でないと次のステップへ進めない場合にのみ、このツールを使う。

Agent が 決済 を使うと、会話には支払いカードが表示され、ユーザーが次に何をすべきか分からなくならないようになります。

ユーザーは次のことができます。

支払い前の決済カード。チェックアウトとステータス操作が見える状態

決済が最終結果に到達すると、その結果を見たまま会話を続けられます。

ステータス	意味
`pending`	決済リクエストは作成済みで、支払い待ちです。
`processing`	ユーザーがチェックアウトに進み、最終結果を確認中です。
`succeeded`	支払いが正常に完了しました。
`failed`	支払いは正常に完了しませんでした。
`cancelled`	支払い完了前にユーザーがキャンセルしました。
`expired`	長時間放置されたため、この決済リクエストは使えなくなりました。

支払い成功後の決済カード画面

決済を終えたあとも、その情報は会話から消えません。

Codeer は支払いサマリーを会話履歴に残すため、あとから Histories を見返すときや、同じ会話を続けるときにも、注文番号、金額、最新ステータスを確認できます。