Skip to content
Docs

AI Gateway Decision Quickstart

Ask a typed question about application state through AI Gateway and get a boolean answer back. This quickstart uses the experimental Decision API, available as experimental_decide in ai 7.0.128 or later. Earlier AI SDK 7 releases call it experimental_evaluate, which still works as a deprecated alias.

Make your first decision

Use a coding agent

Paste this prompt into a coding agent with terminal access:

Agent Prompt

Add a decision request through AI Gateway in the current environment. Use the AI Gateway skill for this task. If it is unavailable, run npx skills add vercel/vercel-plugin --skill ai-gateway, then find and read its SKILL.md before continuing. Reuse the environment's Node.js project, framework, and package manager when possible. Otherwise, add the smallest TypeScript entry point and explain why. Use ai 7.0.128 or later for this quickstart, upgrading an existing ai dependency if it is older, and add only required dependencies. Read AI_GATEWAY_API_KEY from the environment. If it is missing, run npx vercel@latest whoami and pause for login if needed. Determine the team, then run npx vercel@latest --scope <team-slug> ai-gateway api-keys create --name <descriptive-name>. Capture stdout directly into AI_GATEWAY_API_KEY for the request or existing ignored secret storage, and never expose the value. Use typesafe-ai/jev with experimental_decide from the ai package to decide whether a support agent issued a refund, print the structured boolean answer, run the result, and report the output.

Run the Node.js example

Use Node.js 22.18 or later and a team with available AI Gateway Credits. Export AI_GATEWAY_API_KEY in your current shell. If you need a key, open the Create API Key dialog.

Terminal
export AI_GATEWAY_API_KEY="your_ai_gateway_api_key"

Install the latest AI SDK:

Terminal
pnpm add ai@latest

Create index.mts:

index.mts
import { experimental_decide as decide } from 'ai';
 
const result = await decide({
  model: 'typesafe-ai/jev',
  state: 'The support agent issued a full refund to the customer.',
  questions: {
    refunded: {
      type: 'boolean',
      instructions: 'Was a refund issued?',
    },
  },
});
 
console.log(JSON.stringify(result.answers, null, 2));

Run the script:

Terminal
node index.mts

This quickstart logs only result.answers. The probability can vary, but you should see output with this shape:

{
  "refunded": {
    "type": "boolean",
    "probability": 0.99
  }
}

Next steps

Last updated October 7, 2026
Previous
Speech
Next
SDKs & APIs

Was this helpful?

supported.