Source Citations

Source citations show users where the information in responses comes from, building trust and enabling verification.

Source Settings

Display Modes

Expandable (Default)

Sources are hidden behind a collapsible section. Users can click to view citations.

• Clean interface, doesn't clutter responses
• Users can easily verify when needed
• Best for general use cases

Footer

Sources are always visible at the bottom of each response.

• Transparent — users always see where info comes from
• Good for compliance-sensitive applications
• Takes more space in the interface

Inline

Source references are embedded directly in the response text.

• Academic/research style citations
• Clear attribution for each fact
• Best for documentation or research applications

Confidence Scores

When enabled, each source shows its relevance score (0-100%). This helps users understand how well each source matched their query.

Source Information

Each source citation includes:

• Title: Document or section title
• Data source: Where it came from (Notion, PDF, etc.)
• URL: Link to original document (if available)
• Snippet: Preview of matched content

Best Practices

For Customer Support

• Use expandable mode to keep interface clean
• Show 3-5 sources maximum
• Disable confidence scores for simplicity

For Documentation

• Use inline or footer mode for transparency
• Include more sources (5-10)
• Enable confidence scores for power users

For Compliance

• Use footer mode — always visible
• Enable confidence scores for audit trails
• Link to original documents when possible

API Response Format

Sources are included in API responses:

{
  "response": "Our return policy allows...",
  "sources": [
    {
      "rank": 1,
      "title": "Return Policy",
      "dataSourceName": "Help Center",
      "dataSourceType": "web",
      "sourceUrl": "https://help.example.com/returns",
      "content": "...returns within 30 days...",
      "score": 0.94
    }
  ]
}

Disabling Sources

If you don't want to show sources (e.g., for a conversational bot where citations feel unnatural), set show_sources: false.