Interview reference ​
The questionnaire driftbench intake interview writes from an approved map, and the owner answers in place for intake from-interview; see from an interview. The page lists every field, generated from the zod schemas the CLI uses.
- Keys are as written below. An unknown key is an error.
- Descriptions come from the schemas. An empty cell means the schema has no description for that field yet.
Contents ​
- Interview
- Interview personas
- Interview intents
- Interview examples
- Interview never
- Interview languages
- Interview channels
Interview ​
The owner interview: the answers path (ii) of the reference set is built from.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
version | 1 | yes | The version of the interview format, 1. | |
agent | string, not empty | yes | The agent the interview is about; the reference set built from it names the same agent. | |
map | string, not empty | yes | The approved map, as a path relative to this file. | |
personas | list of Interview personas, at least 1 item | yes | The kinds of user who write to the agent, one entry each. | |
intents | list of Interview intents, at least 1 item | yes | How often each intent of the map occurs, and which personas come with it. | |
examples | list of Interview examples, at least 1 item | yes | Example messages a user writes next at a stage, for one persona and one intent. | |
never | list of Interview never | no | [] | What users never do or say, one entry each. |
tone | string | no | `` | How users write in general: length, politeness, typos, emoji, slang. |
languages | list of Interview languages, at least 1 item | yes | The languages users write in, and how often each. | |
channels | list of Interview channels, at least 1 item | yes | How often users come through each channel of the map. |
Interview personas ​
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
id | string matching ^[A-Za-z0-9][A-Za-z0-9._-]*$ | yes | A short name for the persona, such as busy-parent. | |
description | string | yes | Who they are and what they want, in a sentence or two. | |
share | number, at least 0 or null | yes | How often this persona writes, relative to the other personas. | |
map | map of string to string | no | {} | The value of each persona dimension of the map that describes them. |
tone | string | no | `` | How this persona writes: length, politeness, typos, emoji. |
languages | list of strings | yes | The language codes this persona writes in, from languages. | |
channels | list of strings | yes | The channels this persona uses, from channels. |
Interview intents ​
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
value | string, not empty | yes | A value of the intent dimension of the map. | |
share | number, at least 0 or null | yes | How often users come with this intent, relative to the other intents. | |
personas | list of strings, each matching ^[A-Za-z0-9][A-Za-z0-9._-]*$ | no | The personas that come with it. Default: every persona. |
Interview examples ​
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
stage | string, not empty | yes | A value of the stage dimension: where the agent is. | |
intent | string, not empty | yes | The intent of the user. | |
persona | string matching ^[A-Za-z0-9][A-Za-z0-9._-]*$ | yes | The persona who writes. | |
lang | string | no | The language. Default: the persona's first language. | |
channel | string | no | The channel. Default: the persona's first channel. | |
turns | list of strings | yes | What this user writes next at this stage, one message per item. |
Interview never ​
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
text | string, not empty | yes | Something users never do or say. | |
match | list of strings, each not empty | no | [] | Words or phrases that must never appear in a generated turn (case-insensitive). |
Interview languages ​
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
lang | string, not empty | yes | A language code, such as en or nl. | |
share | number, at least 0 or null | yes | How often users write in it, relative to the other languages. | |
map | map of string to string | no | {} | The value of each persona dimension of the map this language falls under. |
Interview channels ​
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
value | string, not empty | yes | A channel of the map. | |
share | number, at least 0 or null | yes | How often users come through it, relative to the other channels. |