Prompt data model
View field support, webhooks, and list parameters for each integration on the Supported Integrations page.
| Field | Type | Required | Description |
|---|---|---|---|
model_id | string | No | The ID of the model to use (a GenaiModel ID) |
messages | GenaiContent[] | No | The conversation to send to the model, in order; each message has a role and its content |
messages[].role | enum | No | Values: SYSTEM, USER, ASSISTANT |
messages[].content | string | Yes | |
messages[].images | string[] | No | Images for the model to evaluate with this message, as base64 data URLs (data:image/png;base64,...). Only for models with has_vision. |
temperature | number | No | 0-1 |
max_tokens | number | No | a float between 0-1 |
responses | string[] | No | |
tokens_used | number | No | |
mcp_url | string | No | Supply a remote MCP URL to send to the LLM API for it to call its tools. Note: Some LLM APIs do not yet support remote MCP URLs. |
mcp_deferred_tools | string[] | No | |
mcp_authorization_token | string | No | OAuth Bearer token for MCP servers that require authentication. |
questions | GenaiQuestion[] | No | Typed questions to evaluate against the messages (for decision models such as TypeSafe Jev). |
questions[].id | string | Yes | A caller-chosen key; the matching answer is returned with the same id. |
questions[].type | enum | Yes | Values: BOOLEAN, CHOICE, SCORE |
questions[].instructions | string | Yes | The question to evaluate. |
questions[].options | string[] | No | CHOICE: the options to select from; SCORE: the ordered levels (lowest first). |
answers | GenaiAnswer[] | No | One answer per question, matched by id. |
answers[].id | string | Yes | The id of the genai_prompt question that this answers. |
answers[].type | enum | Yes | Values: BOOLEAN, CHOICE, SCORE |
answers[].value | string | No | CHOICE: the selected option. |
answers[].score | number | No | SCORE: the probability-weighted level index; BOOLEAN: the probability (0-1) that the answer is yes. |
answers[].probabilities | GenaiAnswerProbability[] | No | CHOICE/SCORE: the probability of every option or level. |
answers[].probabilities[].option | string | Yes | CHOICE: the option; SCORE: the level description. |
answers[].probabilities[].probability | number | Yes | 0-1 |
answers[].confidence | number | No | 0-1: how certain the model is of the answer. |
skill_ids | string[] | No | ids of the genai_skill objects (Agent Skills) to make available to the LLM while it answers. |
Are we missing anything? Let us know