ドキュメント本文へスキップ
API

スレッドへの返信を提案する

閲覧ペインが最新メッセージの下に表示する短い返信。

GET/threads/{id}/reply-suggestions

実際の呼び出しをワークスペースに対して実行します。

GET /threads/{id}/reply-suggestions

閲覧ペインが最新メッセージの下に表示する短い返信。

例

threads:read が必要です。state は、最大 3 件の候補があれば ready、作成中は pending、最新メッセージに返信が不要なら none です。各候補には、ボタンに載せる数語の label と、返信そのものをプレーンテキストで持つ body があり、messageId は候補が答えるメッセージを示します。

curl
curl "$OE/threads/thr_7c1e4a90/reply-suggestions" -H "$AUTH"
レスポンス
{  "object": "reply_suggestions",  "threadId": "thr_7c1e4a90",  "messageId": "msg_51d0be2c",  "state": "ready",  "suggestions": [    { "label": "Invoice coming Friday", "body": "Hi Ada, thanks for signing. I will send the invoice by Friday." },    { "label": "Could it be Monday?", "body": "Hi Ada, thanks for signing. Would Monday work for the invoice instead?" },    { "label": "Where should it go?", "body": "Hi Ada, thanks for signing. Which address should the invoice go to?" }  ]}

候補は新しいメッセージごとに一度だけ作成されて保存されるため、次のメッセージが届くまでは何度問い合わせても消費はありません。作成しても AI アクションは消費しません。

候補は最新メッセージの言語で、ワークスペースが送るメールの口調で書かれます。もとになるのは、会話、その相手との以前のメール、相手の組織についてわかっていること、カレンダーの予定が入っている時間です。

自分の返信で終わったスレッドには候補がなく、ニュースレター、自動通知、no-reply アドレスからのメール、迷惑メール、暗号化されたメッセージも同様です。pending は作成中という意味なので、数秒後にもう一度問い合わせてください。

リファレンス