داشبورد توسعه‌دهنده
پرسش از هوش مصنوعی
پرسش از هوش مصنوعی

Claude Fable 5.2، Gemini 4 Hydrogen و Decision 1 ​

Date: ۱۴۰۵-۰۸-۲۷ / (2026-11-18)

خلاصه ​

Gemini 4 Hydrogen و Gemini Decision 1 در کنار Claude Fable 5.2 در AvalAI در دسترس‌اند. Hydrogen برای کدنویسی روزمره، عامل‌ها و کار چندوجهی مناسب است؛ Decision پرسش‌های بسته را بدون تولید متن ارزیابی می‌کند. این به‌روزرسانی، قیمت فعلی، انتخاب نقطه پایانی و نمونه‌های کامل درخواست و پاسخ را یکجا ارائه می‌دهد.

جزئیات ​

Anthropic: Claude Fable 5.2 ​

از claude-fable-5-2 برای مهندسی نرم‌افزار دشوار، پژوهش چندمرحله‌ای و عامل‌های طولانی‌مدت استفاده کنید. Anthropic این مدل را در ۱۸ آبان ۱۴۰۵ / (2026-11-09) منتشر کرد و از بهبود کدنویسی، استدلال، بینایی و بیان، همراه با تولید خروجی تا ۳۰٪ سریع‌تر از Fable 5.1 خبر داد. این نتایج، ارزیابی ارائه‌دهنده‌اند؛ کیفیت، تأخیر و هزینه کل کار را با داده‌های خود بسنجید.

Anthropic پنجره زمینه ۱٬۰۰۰٬۰۰۰ توکنی مشترک میان ورودی و خروجی، سقف خروجی ۱۲۸٬۰۰۰ توکن، ورودی متن و تصویر و خروجی متن را مستند کرده است. تفکر تطبیقی همواره فعال است. سطح‌های تلاش در سرویس اصلی low، medium، high، xhigh و max هستند و مقدار پیش‌فرض API برابر high است. با درخواست پایه زیر آغاز کنید و سپس کنترل‌های اختیاری را در نقطه پایانی منتخب خود بسنجید.

هنگام ادامه جلسه عامل، بلوک‌های تفکر بومی و بخش پیشین گفتگو را دست‌نخورده نگه دارید. Anthropic تفکر غیرفعال یا با بودجه ثابت و نوع‌های بومی any و tool برای انتخاب اجباری ابزار را رد می‌کند؛ فیلدهای نمونه‌گیری temperature، top_p و top_k را حذف کنید. ارائه‌دهنده همچنین نگهداری داده به مدت ۳۰ روز را مقرر کرده است، مگر اینکه صریحاً نگهداری صفر را مجاز بداند. انتخاب مسیر سازگار با OpenAI یا تنظیم store: false این قواعد سرویس اصلی را تغییر نمی‌دهد.

بخش ارائه‌دهنده Fable و خبر ۲۰ آبان همچنان در دسترس‌اند. این صفحه مقایسه با دو مدل گوگل و نمونه‌های به‌روز اتصال را اضافه می‌کند.

Google: Gemini 4 Hydrogen ​

از gemini-4-hydrogen برای کدنویسی و رفع اشکال روزمره، برنامه‌های تعاملی، عامل‌های دارای ابزار و تحلیل چندوجهی اسناد استفاده کنید. گوگل در خبر ۲۵ آبان ۱۴۰۵ / (2026-11-16)، Hydrogen را مدل سریع‌تر اجرای کار معرفی کرده است که می‌تواند مستقل یا در کنار Carbon و Argon، در گردش‌کاری که برنامه مدیریت می‌کند، به کار رود.

گوگل ورودی متن، تصویر، صدا، ویدیو و PDF را با خروجی متن مستند کرده است. ورودی، تفکر و خروجی در پنجره زمینه مشترک ۱٬۰۴۸٬۵۷۶ توکنی قرار می‌گیرند. سقف خروجی همگام معمولی ۶۵٬۵۳۶ توکن، شامل تفکر است. تولید طولانی‌تر در سرویس اصلی از بخش باقی‌مانده زمینه، با اجرای پس‌زمینه یا ادامه‌دادن درخواست استفاده می‌کند؛ این انتشار، پشتیبانی این قابلیت‌ها را در AvalAI ثابت نمی‌کند. Hydrogen تصویر یا صدا تولید نمی‌کند و از Live API پشتیبانی نمی‌کند.

سطح‌های تفکر low، medium، high (پیش‌فرض) و xhigh هستند. گوگل انتخاب پایین‌ترین سطحی را توصیه می‌کند که هدف‌های ارزیابی شما را برآورده می‌سازد. مقدارهای مجاز temperature، top_p و top_k در سرویس اصلی نادیده گرفته می‌شوند؛ مقدارهای خارج از محدوده خطای اعتبارسنجی می‌دهند. ارجاع‌های حافظه نهان صریح را حذف کنید: Hydrogen فقط از حافظه نهان ضمنی برای ورودی واجد شرایط با دست‌کم ۴٬۰۹۶ توکن پشتیبانی می‌کند. تکرار پرامپت، بازیابی موفق حافظه نهان را در AvalAI تضمین نمی‌کند.

Hydrogen در AvalAI و راهنمای رسمی گوگل را ببینید. قابلیت‌های میزبانی‌شده Google Search، Maps، استفاده از رایانه و اجرای کد به بررسی جداگانه نقطه پایانی نیاز دارند؛ اشتراک‌های محصولات گوگل و رده‌های تخفیفی سرویس اصلی، قیمت AvalAI را تعیین نمی‌کنند.

Google: Gemini Decision 1 ​

از gemini-decision-1 هنگامی استفاده کنید که برنامه به احتمال درست‌بودن یک شرط، یک دسته از مجموعه ثابت یا امتیازی بر اساس معیارهای مرتب‌شده نیاز دارد. کاربردهای آن شامل مسیریابی درخواست، بررسی سیاست‌ها، امتیازدهی نامزدها و انتخاب ابزار مناسب برای برنامه است. این مدل پاسخ گفتگو، فیلدهای استخراج‌شده، شیء JSON دلخواه یا آرگومان فراخوانی ابزار تولید نمی‌کند.

مدل گوگل پرسش‌های مستقل را در یک مرحله پردازش اولیه ارزیابی می‌کند و هیچ توکن خروجی تولید نمی‌کند. محدودیت زمینه در سرویس اصلی ۲۶۲٬۱۴۴ توکن برای ورودی مشترک و همه پرسش‌ها روی‌هم است؛ هر درخواست تا ۱٬۰۰۰ پرسش، هر پرسش انتخابی ۲ تا ۲۵۵ گزینه و هر معیار امتیازدهی ۲ تا ۲۵۵ سطح مرتب‌شده دارد. برای بیشتر معیارها، ۲ تا ۱۰ سطح کافی است. گوگل ورودی متن، تصویر، صدا، ویدیو و PDF را مستند کرده است؛ نمونه‌های قابل‌اجرای AvalAI در این صفحه یک رشته متن مشترک دارند. انتقال رسانه و درخواست‌های بزرگ‌تر به بررسی جداگانه مسیر نیاز دارند.

Decision از سه رابط متفاوت AvalAI پشتیبانی می‌کند که در ادامه آمده‌اند. برای قالب استاندارد آرایه پرسش‌ها از /v1/decisions، برای state و نگاشت پرسش‌های نام‌دار از /v1/systemone و برای input بومی گوگل با نگاشت پرسش‌های نام‌دار از /v1beta/decisions استفاده کنید. این مدل را به Chat Completions، Responses، Messages یا :generateContent نفرستید.

حافظه نهان پشتیبانی نمی‌شود؛ بنابراین ورودی تکراری در درخواست‌های جداگانه به‌طور کامل محاسبه می‌شود. در یک درخواست، متن مشترک فقط یک بار هزینه دارد؛ دستورالعمل، معیارها و قالب هر پرسش نیز به توکن ورودی اضافه می‌شوند. آستانه‌ها را با نمونه‌های برچسب‌خورده تعیین کنید و اعتبارسنجی، بررسی مجوز و اقدام بعدی را در کد برنامه نگه دارید. اطمینان، سیگنال مدل است و درست‌بودن تصمیم را ثابت نمی‌کند.

Decision در AvalAI، مرجع Decisions، مرجع System One و راهنمای مدل‌های تصمیم‌گیری را ببینید.

نقطه‌های پایانی فعال AvalAI ​

شناسه دقیق مدل در AvalAIنقطه‌های پایانی
claude-fable-5-2/v1/chat/completions, /v1/responses, /v1/messages
gemini-4-hydrogen/v1/chat/completions, /v1/responses, /v1/messages، بومی /v1beta/models/gemini-4-hydrogen:generateContent
gemini-decision-1/v1/decisions, /v1/systemone, /v1beta/decisions

قیمت‌گذاری ​

تمام نرخ‌ها دلار آمریکا برای هر یک میلیون توکن و مطابق قیمت فعلی AvalAI هستند. نرخ خروجی Fable و Hydrogen، توکن‌های تفکر قابل‌محاسبه را هم شامل می‌شود.

مدلورودیورودی از حافظه نهانورودی ایجاد حافظه نهانخروجی
claude-fable-5-2$8.00$0.20$10.00$40.00
gemini-4-hydrogen$1.50$0.075—$7.50
gemini-decision-1$0.10پشتیبانی نمی‌شود—$0.00؛ بدون تولید توکن خروجی

نرخ بازیابی حافظه نهان Fable، ۹۷٫۵٪ کمتر از ورودی معمولی است؛ بازیابی ضمنی واجد شرایط در Hydrogen، ۹۵٪ ارزان‌تر است. هر توکن ورودی را فقط یک بار در دسته هزینه مربوط حساب کنید. نرخ ایجاد حافظه نهان Fable به معنی پشتیبانی از همه مدت‌های نگهداری سرویس اصلی نیست. مقدار صفر ورودی از حافظه نهان در فهرست داخلی Decision، وجود حافظه نهان یا رایگان‌بودن ورودی را ثابت نمی‌کند. هزینه ابزار، سهمیه اشتراک ارائه‌دهنده و گزینه‌های Batch، Flex یا Fast سرویس اصلی در این جدول توکن نیستند. قیمت فعلی را ببینید.

نمونه‌های درخواست و پاسخ API ​

AVALAI_API_KEY را از محیط سمت سرور بخوانید. نمونه‌های curl و SDK OpenAI زیر تنها یک تلاش دارند و تکرار خودکار در آن‌ها غیرفعال است؛ مهلت اتصال و پاسخ، انتخاب نمونه برای برنامه‌اند. بودجه خروجی، تفکر را هم شامل می‌شود و ممکن است پیش از کامل‌شدن متن قابل‌نمایش مصرف شود.

همه پاسخ‌های زیر آموزشی‌اند و از فراخوانی زنده AvalAI دریافت نشده‌اند. شناسه‌ها، متن، احتمال‌ها، تعداد توکن، فراداده اختیاری و هزینه‌ها نمونه هستند. نرخ تبدیل نمونه، ۱۰۰٬۰۰۰ تومان برای هر دلار است؛ برای تطبیق هزینه از مقدارهای usage و estimated_cost پاسخ خود استفاده کنید. وضعیت HTTP موفق به‌تنهایی کامل‌بودن پاسخ را ثابت نمی‌کند.

Chat Completions: Fable یا Hydrogen ​

این درخواست از Fable استفاده می‌کند. برای Hydrogen در همین نقطه پایانی، فقط model را به gemini-4-hydrogen تغییر دهید. هر دو messages دارند؛ متن نهایی را از choices[0].message.content بخوانید.

bash
curl --silent --show-error --fail-with-body \
  --connect-timeout 10 --max-time 120 --retry 0 \
  https://api.avalai.ir/v1/chat/completions \
  -H "Authorization: Bearer $AVALAI_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "model": "claude-fable-5-2",
    "messages": [{"role": "user", "content": "In one sentence, explain why a migration needs a rollback plan."}],
    "max_tokens": 2048
  }'
python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AVALAI_API_KEY"],
    base_url="https://api.avalai.ir/v1",
    timeout=120.0,
    max_retries=0,
)
completion = client.chat.completions.create(
    model="claude-fable-5-2",
    messages=[
        {
            "role": "user",
            "content": "In one sentence, explain why a migration needs a rollback plan.",
        }
    ],
    max_tokens=2048,
)
print(completion.choices[0].message.content)
javascript
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.AVALAI_API_KEY,
  baseURL: "https://api.avalai.ir/v1",
  timeout: 120_000,
  maxRetries: 0,
});
const completion = await client.chat.completions.create({
  model: "claude-fable-5-2",
  messages: [{ role: "user", content: "In one sentence, explain why a migration needs a rollback plan." }],
  max_tokens: 2048,
});
console.log(completion.choices[0].message.content);
json
{
  "id": "chatcmpl-fable-example",
  "object": "chat.completion",
  "created": 1794960000,
  "model": "claude-fable-5-2",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "A rollback plan provides a tested way to restore service if a migration fails."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 20,
    "completion_tokens": 100,
    "total_tokens": 120,
    "prompt_tokens_details": {
      "cached_tokens": 0
    }
  },
  "estimated_cost": {
    "unit": "0.0041600000",
    "irt": 416.0,
    "exchange_rate": 100000
  }
}

هزینه نمونه Fable برابر (20 × 8 + 100 × 40) / 1,000,000 = $0.00416 است؛ همین مصرف برای Hydrogen برابر ۰٫۰۰۰۷۸ دلار می‌شود. finish_reason را بررسی کنید: مقدار length یعنی بودجه خروجی به پایان رسیده است.

Responses: Hydrogen یا Fable ​

این نمونه از Hydrogen استفاده می‌کند؛ برای Fable، مقدار model را به claude-fable-5-2 تغییر دهید. Responses از input و max_output_tokens استفاده می‌کند. SDK مقدار response.output_text را ارائه می‌دهد؛ JSON خام دارای آیتم‌های نوع‌دار در output است. پیش از استفاده از پاسخ، status، error و incomplete_details را بررسی کنید.

bash
curl --silent --show-error --fail-with-body \
  --connect-timeout 10 --max-time 120 --retry 0 \
  https://api.avalai.ir/v1/responses \
  -H "Authorization: Bearer $AVALAI_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "model": "gemini-4-hydrogen",
    "input": "In one sentence, explain why a migration needs a rollback plan.",
    "max_output_tokens": 2048
  }'
python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AVALAI_API_KEY"],
    base_url="https://api.avalai.ir/v1",
    timeout=120.0,
    max_retries=0,
)
response = client.responses.create(
    model="gemini-4-hydrogen",
    input="In one sentence, explain why a migration needs a rollback plan.",
    max_output_tokens=2048,
)
print(response.output_text)
javascript
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.AVALAI_API_KEY,
  baseURL: "https://api.avalai.ir/v1",
  timeout: 120_000,
  maxRetries: 0,
});
const response = await client.responses.create({
  model: "gemini-4-hydrogen",
  input: "In one sentence, explain why a migration needs a rollback plan.",
  max_output_tokens: 2048,
});
console.log(response.output_text);
json
{
  "id": "resp_hydrogen_example",
  "object": "response",
  "created_at": 1794960000,
  "status": "completed",
  "error": null,
  "incomplete_details": null,
  "model": "gemini-4-hydrogen",
  "output": [
    {
      "id": "msg_hydrogen_example",
      "type": "message",
      "status": "completed",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "A rollback plan provides a tested way to restore service if a migration fails.",
          "annotations": []
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 20,
    "input_tokens_details": {
      "cached_tokens": 0
    },
    "output_tokens": 100,
    "output_tokens_details": {
      "reasoning_tokens": 80
    },
    "total_tokens": 120
  },
  "estimated_cost": {
    "unit": "0.0007800000",
    "irt": 78.0,
    "exchange_rate": 100000
  }
}

در اینجا ۱۰۰ توکن خروجی شامل ۸۰ توکن استدلال است. هزینه برابر (20 × 1.50 + 100 × 7.50) / 1,000,000 = $0.00078 می‌شود. این پاسخ، پشتیبانی اجرای پس‌زمینه یا ادامه درخواست بومی گوگل را در AvalAI ثابت نمی‌کند.

Messages بومی: Fable یا Hydrogen ​

Messages به max_tokens نیاز دارد و بلوک‌های نوع‌دار content برمی‌گرداند. این نمونه از Fable استفاده می‌کند؛ تغییر شناسه دقیق به gemini-4-hydrogen، Hydrogen را در همین مسیر تأییدشده Messages انتخاب می‌کند. هنگام تنظیم SDK Anthropic، از ریشه میزبان AvalAI بدون /v1 استفاده کنید.

bash
curl --silent --show-error --fail-with-body \
  --connect-timeout 10 --max-time 120 --retry 0 \
  https://api.avalai.ir/v1/messages \
  -H "x-api-key: $AVALAI_API_KEY" \
  -H 'anthropic-version: 2023-06-01' \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "model": "claude-fable-5-2",
    "max_tokens": 2048,
    "messages": [{"role": "user", "content": "In one sentence, explain why a migration needs a rollback plan."}]
  }'
json
{
  "id": "msg_fable_example",
  "type": "message",
  "role": "assistant",
  "model": "claude-fable-5-2",
  "content": [
    {
      "type": "text",
      "text": "A rollback plan provides a tested way to restore service if a migration fails."
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 20,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "output_tokens": 100
  },
  "estimated_cost": {
    "unit": "0.0041600000",
    "irt": 416.0,
    "exchange_rate": 100000
  }
}

بلوک‌های متن را بر اساس نوع بخوانید و هنگام ادامه گفتگو با Fable، بلوک‌های تفکر بومی را حفظ کنید. stop_reason را بررسی کنید؛ امتناع از پاسخ یا پایان بودجه به معنی انجام کامل کار نیست. پاسخ آموزشیِ فقط متنی تضمین نمی‌کند که بلوک‌های تفکر همیشه غایب باشند.

Gemini بومی: Hydrogen ​

از contents و parts همراه :generateContent استفاده کنید. SDK Google GenAI به https://api.avalai.ir با نسخه API برابر v1beta نیاز دارد؛ نشانی پایه OpenAI شامل /v1 را به آن ندهید. این درخواست پایه، حافظه نهان صریح و تغییر سطح تفکر ندارد.

bash
curl --silent --show-error --fail-with-body \
  --connect-timeout 10 --max-time 120 --retry 0 \
  https://api.avalai.ir/v1beta/models/gemini-4-hydrogen:generateContent \
  -H "x-goog-api-key: $AVALAI_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "contents": [{"role": "user", "parts": [{"text": "In one sentence, explain why a migration needs a rollback plan."}]}],
    "generationConfig": {"maxOutputTokens": 2048}
  }'
json
{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "A rollback plan provides a tested way to restore service if a migration fails."
          }
        ]
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 20,
    "candidatesTokenCount": 20,
    "thoughtsTokenCount": 80,
    "totalTokenCount": 120
  },
  "modelVersion": "gemini-4-hydrogen",
  "responseId": "hydrogen-native-example",
  "estimated_cost": {
    "unit": "0.0007800000",
    "irt": 78.0,
    "exchange_rate": 100000
  }
}

نمونه، هزینه ۲۰ توکن ورودی و ۱۰۰ توکن خروجی دارد: ۲۰ توکن پاسخ به‌علاوه ۸۰ توکن تفکر. پیش از خواندن پاسخ، finishReason و بازخورد پرامپت را بررسی کنید. این قالب تولید متن بومی با قالب Decision زیر متفاوت است.

Decisions استاندارد: آرایه پرسش‌ها ​

از input، آرایه پرسش‌های نام‌دار، predicate، choices و levels استفاده کنید. هر پرسش همان داده مشترک را مستقل ارزیابی می‌کند. در این نقطه پایانی، criteria بومی یا فیلد نادرست options را جایگزین choices نکنید.

bash
curl --silent --show-error --fail-with-body \
  --connect-timeout 10 --max-time 30 --retry 0 \
  https://api.avalai.ir/v1/decisions \
  -H "Authorization: Bearer $AVALAI_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary '{
  "model": "gemini-decision-1",
  "input": "The blue mug I ordered arrived cracked and cannot be used.",
  "questions": [
    {
      "name": "is_damaged",
      "type": "predicate",
      "instructions": "Did the item arrive damaged?"
    },
    {
      "name": "queue",
      "type": "choice",
      "instructions": "Which support queue should handle this message?",
      "choices": [
        {
          "value": "billing",
          "description": "Payments, invoices, or refunds."
        },
        {
          "value": "replacements",
          "description": "Damaged, missing, or wrong items."
        },
        {
          "value": "general",
          "description": "Other product or account questions."
        }
      ]
    },
    {
      "name": "severity",
      "type": "score",
      "instructions": "How severe is the issue for the customer?",
      "levels": [
        {
          "label": "Cosmetic",
          "description": "Appearance only; the item still works."
        },
        {
          "label": "Workaround available",
          "description": "The item is degraded but can still be used."
        },
        {
          "label": "Fully blocked",
          "description": "The item cannot be used."
        }
      ]
    }
  ]
}'
json
{
  "model": "gemini-decision-1",
  "answers": [
    {
      "type": "predicate",
      "name": "is_damaged",
      "probability": 0.99
    },
    {
      "type": "choice",
      "name": "queue",
      "choice": "replacements",
      "probabilities": [
        {
          "value": "billing",
          "probability": 0.01
        },
        {
          "value": "replacements",
          "probability": 0.98
        },
        {
          "value": "general",
          "probability": 0.01
        }
      ],
      "confidence": 0.98
    },
    {
      "type": "score",
      "name": "severity",
      "score": 1.7,
      "probabilities": [
        {
          "value": 0,
          "label": "Cosmetic",
          "probability": 0.05
        },
        {
          "value": 1,
          "label": "Workaround available",
          "probability": 0.2
        },
        {
          "value": 2,
          "label": "Fully blocked",
          "probability": 0.75
        }
      ],
      "confidence": 0.75
    }
  ],
  "usage": {
    "input_tokens": 100,
    "output_tokens": 0,
    "total_tokens": 100
  },
  "estimated_cost": {
    "unit": "0.0000100000",
    "irt": 1.0,
    "exchange_rate": 100000
  }
}

پاسخ‌ها را با name و type بخوانید. Predicate مقدار probability، Choice یکی از مقدارهای مجاز و Score میانگین وزنی اندیس سطح‌های مرتب‌شده از صفر را برمی‌گرداند. در این نمونه 0 × 0.05 + 1 × 0.20 + 2 × 0.75 = 1.70 است. امتیاز، درصد یا مقدار استخراج‌شده عینی نیست. هزینه درخواست نمونه برابر 100 × 0.10 / 1,000,000 = $0.00001 است؛ نرخ صفر خروجی، ورودی را رایگان نمی‌کند.

System One: داده state و پرسش‌های نام‌دار ​

همان داوری‌ها با state و نگاشت شناسه پرسش‌ها بیان می‌شوند. نوع بله/خیر noul است؛ گزینه‌ها شیء criteria و امتیازدهی آرایه مرتب‌شده criteria دارند. این نقطه پایانی نگاشت پاسخ برمی‌گرداند، نه آرایه استاندارد Decisions.

bash
curl --silent --show-error --fail-with-body \
  --connect-timeout 10 --max-time 30 --retry 0 \
  https://api.avalai.ir/v1/systemone \
  -H "Authorization: Bearer $AVALAI_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary '{
  "model": "gemini-decision-1",
  "state": "The blue mug I ordered arrived cracked and cannot be used.",
  "questions": {
    "is_damaged": {
      "type": "noul",
      "instructions": "Did the item arrive damaged?"
    },
    "queue": {
      "type": "choice",
      "instructions": "Which support queue should handle this message?",
      "criteria": {
        "billing": "Payments, invoices, or refunds.",
        "replacements": "Damaged, missing, or wrong items.",
        "general": "Other product or account questions."
      }
    },
    "severity": {
      "type": "score",
      "instructions": "How severe is the issue for the customer?",
      "criteria": [
        "Cosmetic: appearance only; the item still works.",
        "Workaround available: the item is degraded but can still be used.",
        "Fully blocked: the item cannot be used."
      ]
    }
  }
}'
json
{
  "model": "gemini-decision-1",
  "answers": {
    "is_damaged": {
      "type": "noul",
      "noul": 0.99,
      "confidence": 0.99
    },
    "queue": {
      "type": "choice",
      "choice": "replacements",
      "probabilities": {
        "billing": 0.01,
        "replacements": 0.98,
        "general": 0.01
      },
      "confidence": 0.98
    },
    "severity": {
      "type": "score",
      "score": 1.7,
      "legend": {
        "0": "Cosmetic: appearance only; the item still works.",
        "1": "Workaround available: the item is degraded but can still be used.",
        "2": "Fully blocked: the item cannot be used."
      },
      "probabilities": {
        "0": 0.05,
        "1": 0.2,
        "2": 0.75
      },
      "confidence": 0.75
    }
  },
  "usage": {
    "input_tokens": 100,
    "output_tokens": 0,
    "total_tokens": 100
  },
  "estimated_cost": {
    "unit": "0.0000100000",
    "irt": 1.0,
    "exchange_rate": 100000
  }
}

answers.is_damaged.noul احتمال بله است، نه یک مقدار بولی تولیدشده. answers.queue.choice را با کلیدهایی که فرستاده‌اید تطبیق دهید. کلیدهای legend امتیاز بومی، اندیس‌های رشته‌ای هستند. احتمال‌ها و اطمینان را همان‌طور که دریافت شده‌اند حفظ کنید؛ فیلد غایب داده نامشخص است، نه صفر.

Decisions بومی گوگل: داده input و پرسش‌های نام‌دار ​

رابط بومی گوگل، input را همراه همان نگاشت پرسش‌های نام‌دار می‌پذیرد. توضیح اختیاری Noul در آن criteria.true_description و criteria.false_description است؛ System One از criteria.true و criteria.false استفاده می‌کند. این پرسش پایه روشن است و به توضیح اضافی نیاز ندارد. نام فیلدهای مصرف بومی total_input_tokens و total_output_tokens است.

bash
curl --silent --show-error --fail-with-body \
  --connect-timeout 10 --max-time 30 --retry 0 \
  https://api.avalai.ir/v1beta/decisions \
  -H "Authorization: Bearer $AVALAI_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary '{
  "model": "gemini-decision-1",
  "input": "The blue mug I ordered arrived cracked and cannot be used.",
  "questions": {
    "is_damaged": {
      "type": "noul",
      "instructions": "Did the item arrive damaged?"
    },
    "queue": {
      "type": "choice",
      "instructions": "Which support queue should handle this message?",
      "criteria": {
        "billing": "Payments, invoices, or refunds.",
        "replacements": "Damaged, missing, or wrong items.",
        "general": "Other product or account questions."
      }
    },
    "severity": {
      "type": "score",
      "instructions": "How severe is the issue for the customer?",
      "criteria": [
        "Cosmetic: appearance only; the item still works.",
        "Workaround available: the item is degraded but can still be used.",
        "Fully blocked: the item cannot be used."
      ]
    }
  }
}'
json
{
  "model": "gemini-decision-1",
  "answers": {
    "is_damaged": {
      "type": "noul",
      "noul": 0.99,
      "confidence": 0.99
    },
    "queue": {
      "type": "choice",
      "choice": "replacements",
      "probabilities": {
        "billing": 0.01,
        "replacements": 0.98,
        "general": 0.01
      },
      "confidence": 0.98
    },
    "severity": {
      "type": "score",
      "score": 1.7,
      "legend": {
        "0": "Cosmetic: appearance only; the item still works.",
        "1": "Workaround available: the item is degraded but can still be used.",
        "2": "Fully blocked: the item cannot be used."
      },
      "probabilities": {
        "0": 0.05,
        "1": 0.2,
        "2": 0.75
      },
      "confidence": 0.75
    }
  },
  "usage": {
    "total_input_tokens": 100,
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 100
      }
    ],
    "total_output_tokens": 0,
    "total_tokens": 100
  },
  "estimated_cost": {
    "unit": "0.0000100000",
    "irt": 1.0,
    "exchange_rate": 100000
  }
}

برای قالب کامل، مرجع Decisions بومی Gemini را ببینید. SDK Google GenAI نسخه ۳٫۲ یا جدیدتر، client.decisions.create(...) / ai.decisions.create(...) را مستند کرده است؛ هنگام سازگارکردن نمونه سرویس اصلی، میزبان AvalAI و نسخه API برابر v1beta را تنظیم کنید. کلید پرسش بومی از ۱ تا ۶۴ نویسه ASCII مطابق [A-Za-z0-9_-]+ تشکیل می‌شود. این نمونه متنی، اجرای SDK، انتقال رسانه یا سقف ۱٬۰۰۰ پرسش سرویس اصلی را در AvalAI تأیید نمی‌کند.

اتصال و رفع اشکال ​

  • قالب تولید متن و Decision را جدا نگه دارید. messages، temperature، max_tokens، tools و stream فیلد اضافه برای درخواست پایه Decision بومی نیستند.
  • احتمال Noul در سرویس اصلی بین ۰٫۰۱ و ۰٫۹۹ است. آستانه را در همین محدوده تعیین کنید و پاسخ غایب، نامعتبر یا ناشناخته را حل‌نشده بدانید. مجموعه بسته گزینه‌ها حتی هنگامی که هیچ گزینه مناسب نیست، بهترین برچسب را دارد؛ گزینه other با توضیح روشن اضافه کنید یا پرسش جداگانه‌ای درباره محدوده کاربرد بپرسید.
  • اطمینان به معنی مجوز اقدام نیست. با نمونه‌های برچسب‌خورده بسنجید، شناسه، نوع و مقدار پاسخ را اعتبارسنجی کنید و موارد نامطمئن یا پرپیامد را برای بازبینی بفرستید. پرسش وابسته به درخواست بعدی نیاز دارد؛ یک پرسش نمی‌تواند در همان فراخوانی پاسخ پرسش دیگر را مصرف کند.
  • برای خطای 400، قالب دقیق درخواست و مدل منتخب را بررسی کنید. پیش از تکرار، فیلد نادرست یا کنترل پشتیبانی‌نشده را اصلاح کنید. پالایش ایمنی بومی گوگل ممکن است به‌جای پاسخ‌ها، 400 با شیء error برگرداند؛ مسدودشدن ایمنی به معنی Predicate منفی نیست.
  • خطای احراز هویت، دسترسی یا پایان اعتبار را پیش از تکرار برطرف کنید. فقط محدودسازی موقت واقعی یا خطای گذرای درگاه را با سقف تلاش و مهلت کل تکرار کنید و در صورت وجود، Retry-After را رعایت کنید. اقدام بعدی برنامه را بیرون از حلقه تکرار نگه دارید.
  • برای رفع اشکال، نقطه پایانی، شناسه دقیق مدل، وضعیت HTTP، بدنه خطای امن و avalai-request-id را نگه دارید. هدرهای پاسخ، مدیریت خطا و محدودیت نرخ را ببینید.

مستندات و منابع مرتبط ​