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

# ask

> Free-form questions answered locally from allowed categories.

## `ask`

Tier: `free_form_read`.

```json theme={null}
{ "question": "When is my next flight?" }
```

| Field      | Rules                               |
| ---------- | ----------------------------------- |
| `question` | Required string, max 500 characters |

## Success

```json theme={null}
{ "answer": "Your next flight is …", "sources": 2 }
```

`answer` is short (roughly ≤ 600 chars) and redacted for codes / card-like numbers.
`sources` is a count of underlying matches — not raw mail.

If nothing answerable: `{"error":"no_answer",…}`.

## Guidance for models

* One question per call.
* Prefer concrete questions over “summarize my inbox”.
* Insufficient answer → narrower follow-up; do not jump to `get_excerpt` without clear
  user intent.