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

# agent

AI agent status, configuration, and on-demand responses.

# `rogeriq agent`

**status**

```bash
    rogeriq agent status
    ```

    Shows the current mode (autopilot / copilot / assist), the LLM in use,
    and this month's usage (calls, tokens, cost).

  **config**

```bash
    # Read
    rogeriq agent config

    # Update
    rogeriq agent config --mode copilot --model anthropic/claude-sonnet-4
    ```

    With no flags, prints the current config. Pass any of `--mode`,
    `--model`, `--persona`, `--tone` to update. Requires `write` (or
    `agent:write`) scope.

  **models**

```bash
    rogeriq agent models
    ```

    Lists available LLM models (read from the OpenRouter catalog, cached).

  **respond**

```bash
    rogeriq agent respond con_xxx
    ```

    Runs the full agent pipeline (context assembly, KB retrieval, LLM call)
    and posts the response on the conversation. Honors the project's
    `agent_mode`: in autopilot the message is sent as a customer-visible
    reply; in copilot it's posted as an internal note for review. Returns
    the generated text, confidence, sources, and token usage. Requires
    `write` (or `agent:write`) scope.

  **classify**

```bash
    rogeriq agent classify con_xxx
    ```

    Returns intent, sentiment, suggested priority, and tags for a single
    conversation. Useful for triage automation.

  **suggest**

```bash
    rogeriq agent suggest con_xxx
    ```

    Like `respond` but returns suggestions without posting. Maps to
    Assist mode in the dashboard.

  **knowledge-map**

```bash
    rogeriq agent knowledge-map
    ```

    Shows what the agent has indexed (articles, crawl jobs, integrations).

## Common workflows

### Auto-respond high-confidence tickets

```bash
for id in $(rogeriq conversations list --status open --quiet); do
  result=$(rogeriq agent respond "$id" --json)
  confidence=$(echo "$result" | jq -r '.confidence')
  echo "$id: $confidence"
done
```

### Switch a project to autopilot for the night

```bash
rogeriq agent config --mode autopilot
# Restore in the morning:
rogeriq agent config --mode copilot
```

### Audit who changed the model

The audit log records every `agent.config.updated` and `agent.responded`
event with the API key id. See `Settings → Audit log` in the dashboard,
or query `GET /api/projects/:pid/audit-log?action=agent.config.updated`.