| name | citations |
| description | Proactively include clickable links when referencing entities (persons, conversations, messages). Makes responses actionable. |
Citations Skill
Purpose
When arsenal references persons, conversations, or messages, include clickable links so users can quickly navigate to the relevant data.
Base URL
https://admin.prod.cncorp.io
URL Patterns
| Entity | Pattern | Example |
|---|---|---|
| Person | /persons/{person_id} |
/persons/123 |
| Conversation | /conversations/{conversation_id} |
/conversations/456 |
| Conversation Messages | /conversations/{conversation_id}/messages |
/conversations/456/messages |
| Messages (time-filtered) | /conversations/{id}/messages?start={iso}&end={iso} |
?start=2025-01-01T00:00:00Z&end=2025-01-02T00:00:00Z |
| Jump to Message | /conversations/{id}/messages?messageId={message_id} |
?messageId=789 |
Query Parameters (Messages)
start- ISO-8601 datetime, filter messages after this timeend- ISO-8601 datetime, filter messages before this timemessageId- Jump to specific message (auto-sets ±1 day window)
When to Cite
ALWAYS include citations when:
- Mentioning a person by ID or name (if ID is known)
- Referencing a conversation
- Discussing specific messages or timeframes
- Returning data from sql-reader that includes these entities
- Debugging or investigating user issues
Citation is MANDATORY, not optional. If you know an entity ID, link it.
Citation Format
Inline (preferred for single entities):
Person John Smith ([view](https://admin.prod.cncorp.io/persons/123)) has 3 active conversations.
Standalone (for navigation):
[View conversation in Admin](https://admin.prod.cncorp.io/conversations/456)
Timeframe debugging:
[View messages from 2-3 PM](https://admin.prod.cncorp.io/conversations/456/messages?start=2025-01-15T14:00:00Z&end=2025-01-15T15:00:00Z)
Jump to specific message:
The problematic message ([view](https://admin.prod.cncorp.io/conversations/456/messages?messageId=789)) was sent at 2:34 PM.
Examples
SQL Query Result
When sql-reader returns:
person_id: 123, name: "John Smith", conversation_id: 456
Response should include:
Found John Smith ([view](https://admin.prod.cncorp.io/persons/123)) in conversation ([view](https://admin.prod.cncorp.io/conversations/456)).
Debugging a User Issue
The user reported missing messages around 3 PM yesterday.
[View messages from 2-4 PM](https://admin.prod.cncorp.io/conversations/456/messages?start=2025-01-15T14:00:00Z&end=2025-01-15T16:00:00Z)
I found the issue in message ID 789 ([view](https://admin.prod.cncorp.io/conversations/456/messages?messageId=789)).
Langfuse Trace Investigation
When referencing a conversation from a trace:
Trace abc123 processed conversation 456 ([view](https://admin.prod.cncorp.io/conversations/456/messages)).