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

# Operaciones de `assistant`

<!-- i18n: source=docs/reference/operations/assistant.md blob=8776e14406e66ab7af3b886a055d72761355b550 model=claude-sonnet-5-5 -->
> Esta página es una traducción automática de la [página en 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.


Los campos exactos que recibe y devuelve cada operación `assistant.*`.

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

Cada op es `POST /v1/<op>` sobre HTTP y la herramienta MCP `loom_<op>`. Los campos de identidad (`org`, `namespace`, `agent`, `user_id`, `session_id`) se rellenan a partir del token y de la sesión MCP cuando el transporte puede hacerlo; en una llamada HTTP sin token en un servidor de un solo usuario, se usa la org de la instalación en todas las ops excepto `code.*` y `tracker.*` (que conservan la de su plano), y en [algunas ops](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request) también su espacio de nombres y su agente; consulta [identidades y espacios de nombres](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md). El [índice de operaciones](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md) explica el rol, el tipo y el listado `all` de MCP. Los campos de entrada desconocidos se atienden y se nombran en `ignored_args`.

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

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

## `assistant.ask`

Hazle al asistente de Loom una pregunta sobre este espacio de nombres y obtén una respuesta con citas: qué contiene, cómo se usa, recuentos sobre sus filas y cómo escribirlo mejor.

`POST /v1/assistant.ask` · MCP `loom_assistant_ask` · rol `viewer` · escritura · no se lista en el conjunto de herramientas `all` de MCP

| Campo de entrada | Tipo | Valor por defecto | Significado |
| --- | --- | --- | --- |
| `org` | `str` | obligatorio | El inquilino (primer elemento de la tupla de identidad). |
| `namespace` | `str` | obligatorio | El espacio de nombres que la op lee o escribe. |
| `question` | `str` | obligatorio | La pregunta sobre este espacio de nombres, respondida en nombre de quien llama, de hasta 20,000 caracteres. |
| `history` | `list[AssistantMessage]` | *(calculado)* | Turnos anteriores de la conversación, del más antiguo al más reciente, hasta 50; vacío por defecto. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `mirrored` | `bool` | Verdadero cuando esta respuesta es privada para la sesión protegida de quien llama; falso por defecto. |
| `answer` | `str` | La respuesta del asistente, con sus citas tal como las escribió el agente. |
| `run_id` | `str` | El id de la respuesta: la ejecución bajo la que se registran sus llamadas a herramientas (agent_events.run_id). |
| `model` | `str` | El modelo que respondió. |
| `citations` | `list[AssistantCitation]` | Cada cita de `answer`, comprobada al terminar la respuesta. |
| `support` | `str` | Hasta qué punto la respuesta se apoya en lo que contiene Loom: supported, unsupported, unchecked o none (sin afirmación, como un saludo o una abstención); por defecto unchecked. |
| `unknown_names` | `list[str]` | Nombres de ops que la respuesta escribe entre comillas invertidas, y nombres LOOM_* en cualquier parte, que esta compilación ni sirve ni documenta: nombres que quizá se inventó. |

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