---
title: "oz0 tenant ask"
description: "Usage and flags for oz0 tenant ask."
canonical_url: "https://docs.oz0.ai/reference/cli/oz0/tenant/ask"
---
# oz0 tenant ask

> Usage and flags for oz0 tenant ask.

For: Operators and developers looking up a command.

Ask (oz.ask) is the platform's built-in agent: it reads a person's first message, lists the agents that person may start, and hands the chat to the one that fits, or asks one of them a one-shot question and answers in the chat. The edge checks each of its steps against what the person who started it may do at that moment, so it can never reach an agent they could not start themselves.

Ask runs on one of the tenant's model aliases, the one named default unless --model names another; with no such alias it is not offered, and the chat picker works as before. It is on by default where the alias exists. Admins of the tenant may change it; each change is audited as tenant.ask. With no on or off, it shows the setting (and --model alone changes only the alias; --model '' goes back to default).

## Usage

```bash
oz0 tenant ask <tenant> [on|off] [flags]
```

## Flags

<table>
<thead>
  <tr>
    <th>
      Flag
    </th>
    
    <th>
      Type
    </th>
    
    <th>
      Default
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        --json
      </code>
    </td>
    
    <td>
      bool
    </td>
    
    <td>
      
    </td>
    
    <td>
      print JSON instead of a table
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --model
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      
    </td>
    
    <td>
      the model alias Ask runs on ('' for the alias named default)
    </td>
  </tr>
</tbody>
</table>

## Inherited flags

<table>
<thead>
  <tr>
    <th>
      Flag
    </th>
    
    <th>
      Type
    </th>
    
    <th>
      Default
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        --context
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <code>
        $OZ0_CONTEXT or &lt;config dir>/orchestrator-zero/context.json
      </code>
    </td>
    
    <td>
      CLI context file written by server init
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --log-level
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <code>
        info
      </code>
    </td>
    
    <td>
      log level: debug, info, warn or error
    </td>
  </tr>
</tbody>
</table>

See [all `oz0` commands](https://docs.oz0.ai/reference/cli/oz0) and the [global flags](https://docs.oz0.ai/reference/cli/oz0#global-flags).


## Sitemap

See the full [sitemap](https://docs.oz0.ai/sitemap.md) for all pages.