<a id="assistant-operations"></a>

# Operações `assistant`

<!-- i18n: source=docs/reference/operations/assistant.md blob=8776e14406e66ab7af3b886a055d72761355b550 model=claude-sonnet-5-5 -->
> Esta página é uma tradução automática da [página em inglês](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations/assistant.md), que prevalece.
> Machine-translated from the [English page](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations/assistant.md), which is authoritative.


Os campos exatos que cada operação `assistant.*` recebe e retorna.

<!-- Generated by `python scripts/codegen/docs_reference.py` from the op registry; edit the models, not this page. -->

Toda op é `POST /v1/<op>` via HTTP e a ferramenta MCP `loom_<op>`. Os campos de identidade (`org`, `namespace`, `agent`, `user_id`, `session_id`) são preenchidos a partir do token e da sessão MCP quando o transporte consegue; em uma chamada HTTP sem token em um servidor de usuário único, é preenchida a org da instalação em todas as ops, exceto `code.*` e `tracker.*` (que mantêm a do seu plano), e em [algumas ops](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request) também o namespace e o agente; veja [identidades e namespaces](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md). O [índice de operações](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md) explica role, kind e a listagem `all` do MCP. Campos de entrada desconhecidos são atendidos e citados em `ignored_args`.

<!-- prettier-ignore-start -->

<a id="assistantask"></a>

## `assistant.ask`

Faça ao assistente do Loom uma pergunta sobre este namespace e receba uma resposta com citações: o que ele contém, como é usado, contagens sobre suas linhas e como escrevê-lo melhor.

`POST /v1/assistant.ask` · MCP `loom_assistant_ask` · role `viewer` · escrita · não listada no toolset `all` do MCP

| Campo de entrada | Tipo | Padrão | Significado |
| --- | --- | --- | --- |
| `org` | `str` | obrigatório | O tenant (primeiro elemento da tupla de identidade). |
| `namespace` | `str` | obrigatório | O namespace que a op lê ou escreve. |
| `question` | `str` | obrigatório | A pergunta sobre este namespace, respondida como o chamador, com no máximo 20,000 caracteres. |
| `history` | `list[AssistantMessage]` | *(calculado)* | Turnos anteriores da conversa, do mais antigo ao mais recente, no máximo 50; vazio por padrão. |

| Campo de saída | Tipo | Significado |
| --- | --- | --- |
| `mirrored` | `bool` | Verdadeiro quando esta resposta é privada à sessão protegida do chamador; falso por padrão. |
| `answer` | `str` | A resposta do assistente, com as citações como o agente as escreveu. |
| `run_id` | `str` | O id da resposta: a execução sob a qual suas chamadas de ferramenta são registradas (agent_events.run_id). |
| `model` | `str` | O modelo que respondeu. |
| `citations` | `list[AssistantCitation]` | Cada citação em `answer`, verificada quando a resposta terminou. |
| `support` | `str` | Até que ponto a resposta se apoia no que o Loom contém: supported, unsupported, unchecked ou none (sem afirmação, como uma saudação ou uma abstenção); o padrão é unchecked. |
| `unknown_names` | `list[str]` | Nomes de ops que a resposta escreve entre crases, e nomes LOOM_* em qualquer lugar dela, que esta build não atende nem documenta: nomes que ela pode ter inventado. |

<!-- prettier-ignore-end -->
