本文へスキップ
確率付き型付き回答: 2 つの質問を含む 1 回の呼び出し、はい/いいえの確率と、信頼度付きの選択。

1 つのモデル API からの確率付き型付き回答

, 3分で読めます, By Jaber Jaber

エンジニアリング

RightNow decision model の API は、テキスト、JSON 状態 (ロボットの状態)、画像、音声、PDF、動画 (プレビュー) を受け付け、確率付きの型付き回答を返します。

RightNow decision model は構造化された意思決定を行います。状態と名前付きの質問を送り、確率、信頼度、型付き回答を読み取ります。各回答は、その質問の名前の下に返ってきます。0 から 1 の「はい」か「いいえ」の確率、または選ばれた選択肢とその信頼度、各選択肢の確率です。

ディシジョンモデルとは何ですか?

ディシジョンは、あなたの状態と名前付きの質問を組み合わせ、各結果をその名前の下で返します。状態はテキスト、JSON オブジェクト、または JSON 配列です。

JSON 状態はロボットの状態を記述できます。たとえば {"battery_percent":80,"moving":false} です。コードは state にテキストとして送ります。

各質問には名前、type、instructions があります。Decisionsをご覧いただくか、RightNow decision model の紹介をお読みください。

何を送れますか?

インライン入力: テキスト、JSON 状態 (ロボットの状態)、画像、音声、PDF、動画 (プレビュー)。対応しているのは記載されたフォーマットだけです。

ファイルは state 内のアイテムとして送ります。画像は PNG か JPEG の data URL、PDF は名前付きの data URL、動画は MP4 の data URL、音声はフォーマット付きの base64 WAV データとして送ります。Inputsをご覧ください。

何が返ってきますか?

answers は質問ごとに 1 つの回答を、その質問の名前の下に保持します。noul の回答は 0 から 1 の「はい」か「いいえ」の確率です。choice の回答は選ばれた選択肢で、0 から 1 の confidence と、probabilities の中に各選択肢の確率を伴います。usage.cost はその呼び出しのコストです。

型付き質問 2 つを含む 1 回の呼び出し。状態は注文 1234 が納品後 45 日で返金を求めていると述べ、ポリシーは 30 日までを認めている。yes/no の質問 refund_allowed は 0 から 1 の確率として返る。choice の質問 next_step は approve、deny、escalate として返り、信頼度と各選択肢の確率が付く。
返信の形。各型が値の代わりを務める。あなたのキーで呼び出す

どう呼び出しますか?

API キーページのキーは、すべてのオープンモデルと同じベース URL で RightNow decision model を呼び出します。API キーページのキーを使って、POST /v1/decisions を呼びます。model として rightnow-decision を送ります。現在のモデルに追従するにはエイリアスを、バージョンを固定するには ID を使います。

Shell
curl https://api.rightnowai.co/v1/decisions \
  -H "Authorization: Bearer $RIGHTNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "rightnow-decision",
    "state": "Order 1234: the customer asks for a refund 45 days after delivery. The policy allows 30 days.",
    "questions": {
      "refund_allowed": {"type": "noul", "instructions": "Is the refund allowed under the policy?"},
      "next_step": {"type": "choice", "instructions": "What should support do next?",
        "options": ["approve", "deny", "escalate"]}
    }
  }'
A call with your key. Call it with your key

呼び出しを行うプロセスで RIGHTNOW_API_KEY を設定します。キーはサーバーに置き、HTTPS 経由で呼び出してください。クイックスタートをご覧ください。

いくらかかりますか?

RightNow decision model では、入力、回答された質問、回答された呼び出しに対して支払います。

Uncached text input costs USD 0.19 per million input tokens, and cached text input USD 0.019. Each answered question costs USD 0.0001, and each answered call USD 0.00001. Output is free.

ファイル付きの呼び出しは、テキスト価格と価格表の各ファイルの手数料がかかります。拒否された質問には課金されません。料金をご覧ください。

制限はどこにありますか?

標準のテキスト状態は最大 38,000 トークンに対応します。API キーページのキーでは、音声は WAV のみで、1 回の呼び出しに含められる質問は最大 32 です。

音声はリクエストごとに 60 秒までです。1 リクエストあたり最大 4 画像を送れます。PDF は最大 500 ページです。他のファイルなしで、10 秒までの無音の H.264 MP4 を 1 つ送ります。

calibrated はこのリリースでは false です。

API キーページのキーには毎分の独自制限があります: 応答の X-RateLimit-Limit を読んでください。Inputsとレート制限をご覧ください。

短い回答

どの質問型を使うべきですか?

noul は「はい」か「いいえ」の確率です。テキストの呼び出しでは、choice は 2 から 10 の options、score は 2 から 4 の levels を取ります。

ファイルを送れますか?

はい。ファイルはインラインで送ります。使えるのは記載されたフォーマットだけです。

どのモデル ID を送りますか?

rightnow-decision を送ります。バージョンを固定するには rightnow-decision-3.0.0 を使います。

キーはどう手に入れますか?

有効なワークスペースで、API キーの下に名前付きキーを作成します。キーはそのワークスペースに属し、一度だけ表示されます。

拒否された質問は課金されますか?

されません。すべてが拒否されたリクエストには、テキスト、質問、ファイル、呼び出しの課金がありません。