> Source: https://clickhouse.github.io/loom/ja/reference/operations/assistant/ (Markdown: https://clickhouse.github.io/loom/ja/reference/operations/assistant.md)

> この機械翻訳の作成後に英語の原文が更新されています。最新の手順は[英語のページ](https://clickhouse.github.io/loom/reference/operations/assistant/)を参照してください。

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

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

# `assistant` オペレーション

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

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

すべてのオペレーションは、HTTP では `POST /v1/<op>`、MCP ではツール `loom_<op>` として呼び出せます。ID フィールド（`org`、`namespace`、`agent`、`user_id`、`session_id`）は、トランスポートが対応している場合にトークンと MCP セッションから補完されます。シングルユーザーサーバーでトークンなしの HTTP 呼び出しを行う場合、`code.*` と `tracker.*`（それぞれのプレーンの org を保持します）を除くすべてのオペレーションで、インストールの org が補完されます。[一部のオペレーション](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` | 必須 | オペレーションが読み書きする名前空間。 |
| `question` | `str` | 必須 | この名前空間についての質問。呼び出し元として回答されます。最大 20,000 文字。 |
| `history` | `list[AssistantMessage]` | *(計算)* | これまでの会話のターン。古い順で、最大 50 件。デフォルトは空です。 |

| 出力フィールド | 型 | 意味 |
| --- | --- | --- |
| `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]` | 回答中でバッククォートで囲まれたオペレーション名と、回答中のあらゆる場所にある LOOM_* 名のうち、このビルドが提供も文書化もしていないもの。作り出された可能性のある名前です。 |

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