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

# AI commands - Omni CLI

> Reference for the omni ai command group: query generation, jobs, conversations, and credit controls.

AI-powered query generation, job management, and documentation search. See the [AI API documentation](/api/ai) for more information.

<Note>
  AI evals, model suggestions, and routines have their own command groups: [`omni ai-eval`](/developers/cli/commands/ai-eval), [`omni ai-model-suggestions`](/developers/cli/commands/ai-model-suggestions), and [`omni ai-routines`](/developers/cli/commands/ai-routines).
</Note>

```bash theme={null}
omni ai <command> 
```

| Command                                | Description                                                   |
| -------------------------------------- | ------------------------------------------------------------- |
| `generate-query`                       | Generate and optionally execute a query from natural language |
| `pick-topic`                           | Pick the best topic for a prompt                              |
| `search-omni-docs`                     | Search Omni documentation                                     |
| `job-submit`                           | Submit an AI job                                              |
| `job-status`                           | Get AI job status                                             |
| `job-cancel`                           | Cancel an AI job                                              |
| `job-result`                           | Get AI job result                                             |
| `job-visualization`                    | Render AI job visualization                                   |
| `branding`                             | Get AI helper branding                                        |
| `conversations-list`                   | List AI conversations                                         |
| `conversation-detail`                  | Get AI conversation with messages                             |
| `credit-controls-get`                  | Get AI credit controls                                        |
| `credit-controls-update`               | Update AI credit controls                                     |
| `credit-controls-users-list`           | List individual users' AI credit limits                       |
| `credit-controls-users-update`         | Set individual users' AI credit limits                        |
| `credit-controls-entity-groups-list`   | List individual entity groups' AI credit limits               |
| `credit-controls-entity-groups-update` | Set individual entity groups' AI credit limits                |
| `credit-usage-users-read`              | Read individual users' AI credit usage                        |
| `credit-usage-entity-groups-read`      | Read individual entity groups' AI credit usage                |

```bash wrap theme={null}
# Answer a question about your data
omni ai generate-query --body '{"modelId":"MODEL_ID","prompt":"how many active users","executeQuery":true}'

# Search the Omni docs
omni ai search-omni-docs --body '{"query":"how do I..."}'

# View help for job-status command, including arguments and flag details
omni ai job-status --help
```

<Note>
  Every command in this group also accepts the [global flags](/developers/cli/reference/global-flags), including `--token`, `--profile`, `--format`, and `--compact`.
</Note>