When writing AIP instructions, you can reference three types of capabilities using the @ mention system:
- Player Context — Read-only data from your backoffice (balances, transactions, status)
- Knowledge — Articles from your Knowledge Base
- Actions — Operations that change state (escalate, route, close, tag)
Type @ in the instructions editor to open a dropdown with tabs for each type.
Player Context
Player Context gives Cevro access to data from your backoffice systems. These are configured by your technical team during integration setup.
How It Works
When you mention Player Context in instructions, Cevro calls your backoffice API to fetch that data during the conversation.
Check @withdrawalStatus for pending requests.
If pending:
- Share the status and expected timeframe
If no pending withdrawals:
- Ask the player for more details
Common Player Context Examples
Depending on your integration, you might have access to:
| Context | What It Returns |
|---|
@playerBalance | Current account balance |
@withdrawalStatus | Pending withdrawal requests |
@depositHistory | Recent deposits |
@bonusStatus | Active bonuses and wagering progress |
@verificationStatus | KYC document status |
@vipLevel | Player tier and benefits |
Your available Player Context depends on what your backoffice integration provides. Check with your account executive if you need additional data.
Authentication Requirement
When an AIP uses Player Context, Cevro needs to verify the player’s identity to fetch their data. The Require Player Authentication toggle auto-enables when you reference Player Context in your instructions.
Knowledge
The Knowledge tab lets you reference specific articles from your Knowledge Base in your instructions.
When to Use Knowledge References
- Procedures that need reference data — A “Payment Method Issues” AIP might reference an “Accepted Payment Methods” article so Cevro can look up which methods work
- Brand-specific information — Knowledge Base articles are segmented by brand, so you can store brand-specific details and reference them
Using Knowledge in Instructions
If the player asks about accepted payment methods:
- Check @Accepted Payment Methods for their region
- Explain which methods are available
If the player's method isn't listed:
- Suggest alternatives from the article
Multi-Brand Awareness
The Knowledge tab shows which brands have each article:
- Fuzzy matching groups similar titles (“Accepted Payment Methods” ≈ “Payment Methods Accepted”)
- Shows coverage like “10 brands have this, 2 brands missing”
- Helps you identify content gaps to fill
Actions
Actions let Cevro perform operations during a conversation—not just read data, but actually do things.
Built-In Actions
Every workspace has access to these core actions:
| Action | What It Does |
|---|
| Transfer to Live Agent | Hands off the conversation to a human agent |
| Route to AI Procedure | Switches to a different AIP mid-conversation |
| Close Ticket | Ends the conversation and marks it resolved |
| Add Tags | Applies labels for categorization and reporting |
| Send External Message | Sends a notification outside the main conversation |
Using Actions in Instructions
Reference actions the same way you reference Player Context—with @:
If the issue is resolved:
- Thank the player
- @Close Ticket
If the player needs billing help:
- @Route to AI Procedure and select "Billing Support"
If the issue requires human judgment:
- Explain that you're connecting them to a specialist
- @Transfer to Live Agent
Custom Actions
Some workspaces have additional actions based on their backoffice integration:
- Assign bonuses
- Reset passwords
- Update account status
- Send follow-up emails
These appear in the Actions tab alongside built-in actions if they’re configured for your workspace.
Human-in-the-Loop (HITL)
For situations requiring human specialist input before continuing, Cevro supports Human-in-the-Loop workflows. When triggered, the AI pauses automation, requests input from a specialist (via Slack, Teams, email, or Intercom), and continues once they respond.
See Human-in-the-Loop for configuration details.
The @ Mention Dropdown
When you type @ in the instructions editor, a dropdown appears with three tabs:
| Tab | Contents |
|---|
| Player Context | Data lookups from your backoffice |
| Knowledge | Articles from your knowledge base |
| Actions | Operations (escalate, route, close, tag) |
Best Practices
Check data before acting on it
Check @withdrawalStatus first.
If withdrawal is pending:
- Explain the status
- No need to escalate
If withdrawal is stuck:
- @Transfer to Live Agent
If escalating:
- @Add Tags with "needs-review"
- @Transfer to Live Agent
If this is actually a deposits question:
- Acknowledge the topic change
- @Route to AI Procedure and select "Deposit Issues"
Troubleshooting
| Issue | Check |
|---|
| Player Context not returning data | Is authentication enabled? Is the backoffice integration working? |
| Action not appearing in dropdown | Is it a custom action that needs configuration? Check with your account executive. |
| ”Authentication required” errors | The AIP uses Player Context but authentication isn’t set up for this channel. |
