> ## Documentation Index
> Fetch the complete documentation index at: https://docs.holydocs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Assistant and AI

Configure the embedded AI assistant, starter questions, support deflection, and AI-facing docs behavior.

## Assistant widget

```json
{
  "assistant": {
    "enabled": true,
    "name": "Acme Helper",
    "greeting": "Ask about setup, APIs, or troubleshooting.",
    "model": "anthropic/claude-sonnet-4",
    "suggestedQuestions": [
      "How do I authenticate requests?",
      "How do I deploy docs?",
      "How do redirects work?"
    ],
    "position": "bottom-right"
  }
}
```

| Field | Notes |
|---|---|
| `name` | Chat header label |
| `greeting` | First message when the panel opens |
| `model` | Provider/model slug |
| `systemPrompt` | Max 2000 characters |
| `suggestedQuestions` | Up to 4 |
| `position` | `bottom-right` or `bottom-left` |

## Theme and support handoff

```json
{
  "assistant": {
    "theme": {
      "accentColor": "#FBBF24",
      "icon": "sparkle"
    },
    "contactSupport": {
      "enabled": true,
      "email": "support@example.com",
      "label": "Talk to support"
    },
    "deflection": {
      "enabled": true,
      "supportEmail": "support@example.com",
      "showHelpButton": true
    }
  }
}
```

Use support handoff when the assistant should escalate rather than hallucinate a policy or account-specific answer.

## AI-aware docs strategy

**Keep questions real**

Starter questions should mirror actual user intents, not generic marketing prompts.
  **Page granularity matters**

Smaller, single-purpose pages improve retrieval quality for search and assistant answers.
  **Link to canonical pages**

Use overview pages as hubs and detail pages as answer targets.

## Related pages

- [AI Assistant](/ai-assistant)
- [AI Search](/ai-search)
- [AI Agent](/ai-agent)
- [llms.txt](/llms-txt)