The system prompt lets you customize how Airia Agent presents itself and responds within your organization. Your instructions are applied on top of Airia Agent’s base behavior — think of it as the standing brief you give a new employee about how your organization works, what it cares about, and how it communicates.
Access the System Prompts tab
Navigate to Settings → Airia Agent → System Prompts.
Write an effective system prompt
A good system prompt is specific and behavioral. Focus on what the agent should do differently from its defaults, not what it already does well on its own.
Persona and tone
Define how Airia Agent should present itself:
You are the internal AI assistant for Acme Corp. Respond in a professional but approachable tone. Refer to users by first name when it is known.
Topic focus and restrictions
Scope Airia Agent to relevant topics and instruct it on what to decline:
Your primary purpose is to help Acme employees with HR questions, IT support, and internal process guidance. For questions about customer contracts or pricing, direct users to the Sales team at sales-support@acme.com.
Escalation rules
Tell Airia Agent when and how to hand off to a human or another channel:
If a user reports a security incident or a data breach, stop the conversation and immediately direct them to security@acme.com with the subject line "Urgent: Security Incident".
Organization-specific knowledge
Embed facts that Airia Agent should treat as authoritative:
Acme's fiscal year runs from February 1 to January 31. When discussing budgets or timelines, use this calendar unless the user specifies otherwise.
When users ask about project status or deadlines, use the Project Tracker tool rather than general knowledge.
When users raise payroll or benefits questions, delegate to the HR Assistant agent.
What the system prompt does not do
- It is not visible to end users. Users do not see the prompt text.
- It does not override tool descriptions. Tool selection is driven primarily by tool metadata; the system prompt can guide but not override that selection.
- It does not override safety policies. Airia’s platform-level policies (DLP, policy constraints) apply regardless of prompt content.
Save and test your changes
After writing or editing the prompt:
- Click Save
- Open Chat as an end user (or use a test account)
- Send a few representative messages and verify Airia Agent responds as expected
Use Inline Test mode in Agent Studio if you need to iterate quickly before applying changes tenant-wide.
Prompt persistence across upgrades
Your custom system prompt is preserved automatically when you apply a version upgrade to Airia Agent. You do not need to re-enter it after an upgrade. However, it is good practice to review the prompt after a major upgrade to ensure it remains accurate given any new capabilities the upgrade introduces.
See Version Management for details on the upgrade process. 
