---
title: "`assistant` オペレーション"
---

<!-- i18n: source=docs/reference/operations/assistant.md blob=8776e14406e66ab7af3b886a055d72761355b550 model=claude-sonnet-5-5 -->
> このページは[英語の原文](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations/assistant.md)の機械翻訳です。内容は英語の原文が優先されます。
> Machine-translated from the [English page](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations/assistant.md), which is authoritative.

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

各 `assistant.*` オペレーションが受け取り、返すフィールドの正確な定義です。

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

すべての op は HTTP の `POST /v1/<op>` と MCP ツール `loom_<op>` で呼び出せます。ID フィールド（`org`、`namespace`、`agent`、`user_id`、`session_id`）は、トランスポートが対応している場合にトークンと MCP セッションから補完されます。シングルユーザーのサーバーでトークンなしの HTTP 呼び出しを行う場合は、`code.*` と `tracker.*`（それぞれのプレーンの値を保持します）を除くすべての op でインストールの org が補完され、[一部の op](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request) では名前空間とエージェントも補完されます。詳しくは [ID と名前空間](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md)を参照してください。ロール、種別、MCP の `all` 一覧については[オペレーション一覧](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md)で説明しています。未知の入力フィールドは受け付けられ、`ignored_args` に名前が示されます。

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

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

## `assistant.ask`

この名前空間について Loom アシスタントに 1 つ質問し、出典付きの回答を 1 つ得ます。名前空間が保持している内容、その使われ方、行数の集計、より良い書き込み方を尋ねられます。

`POST /v1/assistant.ask` · MCP `loom_assistant_ask` · ロール `viewer` · 書き込み · MCP の `all` ツールセットには含まれません

| 入力フィールド | 型 | デフォルト | 意味 |
| --- | --- | --- | --- |
| `org` | `str` | 必須 | テナント（ID タプルの最初の要素）。 |
| `namespace` | `str` | 必須 | op が読み書きする名前空間。 |
| `question` | `str` | 必須 | この名前空間に関する質問。呼び出し元として回答されます。最大 20,000 文字。 |
| `history` | `list[AssistantMessage]` | *(算出)* | 会話のこれまでのターン。古い順で最大 50 件。デフォルトは空です。 |

| 出力フィールド | 型 | 意味 |
| --- | --- | --- |
| `mirrored` | `bool` | この回答が呼び出し元の保護されたセッション内に限られる場合は true。デフォルトは false です。 |
| `answer` | `str` | アシスタントの回答。引用はエージェントが書いたままの形で含まれます。 |
| `run_id` | `str` | 回答の ID。ツール呼び出しが記録される実行（agent_events.run_id）です。 |
| `model` | `str` | 回答したモデル。 |
| `citations` | `list[AssistantCitation]` | `answer` 内の各引用。回答の終了時に検証されます。 |
| `support` | `str` | 回答が Loom の保持する内容にどこまで基づいているか。supported、unsupported、unchecked、none（挨拶や回答の保留など、主張を含まない場合）のいずれかで、デフォルトは unchecked です。 |
| `unknown_names` | `list[str]` | 回答中でバッククォートで囲まれた op 名と、回答中のあらゆる位置にある LOOM_* 名のうち、このビルドが提供も文書化もしていないもの。回答が作り出した可能性のある名前です。 |

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