Quick reference
| Setting | Default | What it does |
|---|---|---|
| Date and time context | On | Adds a system message with the current date and time |
| Timezone | UTC | Controls which timezone the date/time is presented in |
| User details context | On | Adds a system message with the user’s profile and preferences |
| Always include user input | On | Ensures the original user message reaches the model, even when the step is not directly connected to the Input step |
| Include Attachments | On | Passes uploaded files and images into the model’s context |
| Include the chat history | All history | Sends previous conversation turns so the model can follow multi-turn dialogue |
Date and time context
When enabled, Airia injects a system message before your prompt:- When to enable
- When to disable
- Agents that answer questions about dates, deadlines, or schedules
- Workflow agents triggered on a cron that need to know “today”
- Any prompt that includes phrases like “as of today” or “this quarter”
Timezone
Controls the timezone applied to the date/time context message. The dropdown offers three modes:| Mode | Behaviour | Best for |
|---|---|---|
| UTC (default) | Timestamp is always in UTC (+00:00) | Backend agents, cron jobs, internal tooling where a consistent reference is preferred |
| Custom | A fixed IANA timezone you choose (e.g., America/New_York, Europe/London) | Agents that serve a known geography — e.g., a customer support bot for US East Coast hours |
| Client | Uses the end user’s browser timezone, sent at execution time | Global-facing chat agents where each user expects times in their own local zone |
If the client timezone is unavailable at runtime (e.g., the agent was triggered via API without timezone data), Airia falls back to UTC silently.
User details context
When enabled, Airia injects a system message containing the authenticated user’s profile:| Field | What it contains |
|---|---|
General | Free-text bio or role description |
WorkDescription | The user’s job function or responsibilities |
PersonalPreferences | Communication style, formatting, or language preferences |
- When to enable
- When to disable
- Personalised assistants that adapt tone, detail level, or vocabulary to the user
- Agents that need to know the user’s role to scope their answers (e.g., executive summary vs. technical deep-dive)
- Internal tools where users have filled in their Airia profile
Always include user input
In a multi-step agent, not every AI Model step is directly connected to the Input step. For example, a three-step pipeline might look like:- When to enable
- When to disable
- Most agents — you almost always want the model to see the user’s original question
- Multi-step agents where downstream steps need the original request for grounding
- Agents where the upstream step transforms or summarises the input, but the final model still needs the raw question
Include Attachments
When enabled, any files or images the user uploads with their message are added to the model’s context. This includes:| Included data | Description |
|---|---|
| File name | The original filename (e.g., Q1-report.pdf) |
| Content type | MIME type (e.g., application/pdf, image/png) |
| File content | The file’s content, processed for the model to read |
- When to enable
- When to disable
- Document Q&A agents (“summarise this PDF”, “extract the table from this image”)
- Agents that analyse uploaded images (charts, screenshots, photos)
- Any agent where users are expected to attach files as part of their workflow
Not all models support all file types. Vision-capable models (GPT-4o, Claude 3.5 Sonnet, Gemini Pro Vision, etc.) can process images natively. For non-vision models, only text-extractable content (like parsed PDFs) will be useful. Check your model’s capabilities before relying on attachment processing.
Include the chat history
Controls how much of the conversation the model can see. Click the dropdown to choose one of three modes:All history
Every previous message in the conversation is included. The model has full context of everything said so far.
Last N messages
Only the most recent N messages are included. You specify the number. Older messages are silently dropped.
No history
No previous messages are included. The model treats every request as if it is the first message in the conversation.
Choosing the right mode
| Mode | Best for | Trade-off |
|---|---|---|
| All history | Conversational assistants, multi-turn reasoning, coaching bots | Token usage grows with conversation length. Long conversations can hit context window limits. |
| Last N messages | Assistants with long sessions where only recent context matters (e.g., customer support, troubleshooting) | Good balance of continuity and cost control. Experiment with N — 10–20 messages is a common starting point. |
| No history | Single-shot tasks (classification, data extraction), webhook-triggered agents, scheduled pipelines | No conversational memory. Each execution is stateless. Lowest token cost. |
How context settings relate to prompt expressions
Context settings and prompt expressions are two complementary ways to give the model runtime information. They are not mutually exclusive — many agents use both.| Mechanism | How it works | When to use |
|---|---|---|
| Context settings (this page) | Airia injects pre-formatted system messages automatically. You do not write them — they appear alongside your prompt. | When you want the information available to the model without embedding it in your prompt text. Simple toggle, zero prompt editing. |
Prompt expressions ({{ }}) | You write Scriban expressions directly inside your prompt. They are evaluated at runtime and replaced with values. | When you need precise control over wording, placement, or conditional logic around the data. |
{{ Helpers.CurrentDateTime }} lets you embed the same timestamp inside your own instructions:
Recommended presets by agent type
- Conversational assistant
- Single-shot classifier
- Document processing pipeline
- Scheduled background agent
A general-purpose chat agent that talks to end users.
| Setting | Value | Why |
|---|---|---|
| Date and time context | On | Users ask time-sensitive questions |
| Timezone | Client | Each user sees times in their own zone |
| User details context | On | Personalises tone and depth |
| Always include user input | On | Model always sees the question |
| Include Attachments | On | Users may share files |
| Include the chat history | All history | Multi-turn conversation requires full context |
Troubleshooting
Model doesn't know today's date
Model doesn't know today's date
Enable Date and time context in the Context panel. Without it, the model can only guess the date based on its training data — which will be wrong.If it is already enabled and the model still gets the date wrong, check whether your prompt contains conflicting date references (e.g., a hardcoded “Today is January 1, 2025” in a shared segment). The model may trust the explicit prompt text over the injected system message.
Model keeps referencing old messages or contradicting itself
Model keeps referencing old messages or contradicting itself
This usually happens with All history on long conversations. As the conversation grows, the model’s effective attention can drift. Try switching to Last N messages (start with 10–20) to keep the context focused on the recent exchange.
Token usage is unexpectedly high
Token usage is unexpectedly high
Two common causes:
- Chat history set to All: Every previous message is sent on every turn. A 50-message conversation means 50+ messages in the context window on the 51st turn.
- Attachments enabled with large files: Uploaded documents consume significant tokens. If your agent does not process files, disable Include Attachments.
Model ignores the user's question in a multi-step agent
Model ignores the user's question in a multi-step agent
Check that Always include user input is enabled on the AI Model step that needs to see the original message. In multi-step flows, downstream steps do not receive the user’s input automatically unless this setting is on.
