---

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 time
• end - ISO-8601 datetime, filter messages before this time
• messageId - 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)).