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

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

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

# `mentor` オペレーション

各 `mentor.*` オペレーションが受け取る入力フィールドと返す出力フィールドを、正確に示します。

<!-- 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 が補完されます。[一部のオペレーション](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="mentorbrief"></a>

## `mentor.brief`

1 つのエージェントの利用プロファイルと、ストアからのヒント。

`POST /v1/mentor.brief` · MCP `loom_mentor_brief` · ロール `viewer` · 読み取り

| 入力フィールド | 型 | デフォルト | 意味 |
| --- | --- | --- | --- |
| `org` | `str` | 必須 | テナント（ID タプルの最初の要素）。 |
| `namespace` | `str` | 必須 | オペレーションが読み書きする名前空間。 |
| `agent` | `str` | `''` | 書き込みまたは読み取りを行うエージェント。オペレーションが許す場合、`'-'` または `'*'` は任意のエージェントを意味します。 |
| `window_seconds` | `int` | `604800` | 台帳の読み取りがさかのぼる範囲（秒）。1 時間から 90 日まで。 |

| 出力フィールド | 型 | 意味 |
| --- | --- | --- |
| `org` | `str` | テナント（ID タプルの最初の要素）。 |
| `namespace` | `str` | オペレーションが読み書きする名前空間。 |
| `agent` | `str` | 書き込みまたは読み取りを行うエージェント。オペレーションが許す場合、`'-'` または `'*'` は任意のエージェントを意味します。 |
| `window_seconds` | `int` | プロファイルを算出した期間（秒）。キャッシュから返されたプロファイルは、算出時の期間を保持します。 |
| `computed_at` | `datetime` | プロファイルを算出した時刻（UTC）。キャッシュから返された場合は、呼び出しより前の時刻になります。 |
| `sessions` | `int` | 期間内にこのエージェントが持った、クライアントが名前を付けたセッションの数（重複なし。`-` と `*` は数えません）。 |
| `usage` | `dict[str, int]` | 期間内にこのエージェントが呼び出した、オペレーションごとの回数。 |
| `planes` | `list[MentorPlane]` | メンターが把握しているすべてのプレーン。このエージェントによる呼び出し回数と、利用可能かどうかを含みます。 |
| `hints` | `list[MentorHint]` | このエージェントに対して発火したルール。それぞれ発火の根拠となったカウントを含み、なければ空です。 |
| `adoption` | `list[MentorAdoption]` | ヒントコードごとに、表示されたセッション数と従われたセッション数。表示数の多い順です。ヒントがエージェントに届かなかった場合や、読み取りに失敗した場合は空です。 |
| `usage_evidence` | `list[UsageRung]` | 期間内のエージェントによる Loom の利用状況。1 段ごとに、主張の弱いものから順に、呼び出しの実行から採点済みの実行までを示します。 |
| `ledger_from` | `datetime \| None` | 期間内のこのエージェントの台帳で最も古い行（種類は問いません）。行がない場合や読み取りに失敗した場合は None。 |
| `ledger_retention_days` | `int \| None` | 設定された保持期間が、この名前空間の呼び出し台帳の行を保持する日数。0 は削除されるまで保持を意味し、読み取りに失敗した場合は None。 |
| `agents` | `list[str]` | 期間内のこの名前空間の書き込み元。活動の多い順です。呼び出し元が自身のエージェント名を持たない場合（ダッシュボードなど）、ブリーフは先頭を既定値とし、`agent_defaulted` がそれを示します。 |
| `agent_defaulted` | `bool` | 呼び出し元が実在するエージェント名を指定せず、ブリーフが `agents` の最も活発な書き込み元を選んだ場合は True。 |
| `skipped` | `list[str]` | ブリーフが読み取れなかった事実。「step: reason」の形式。 |
| `healthy` | `bool` | 警告またはクリティカルのヒントがないこと。 |

<a id="mentorguide"></a>

## `mentor.guide`

このサーバーが提供するエージェント向けガイド。どの呼び出し元に対しても同じ内容です。

`POST /v1/mentor.guide` · MCP `loom_mentor_guide` · ロール `viewer` · 読み取り · MCP の `all` ツールセットには含まれません

| 入力フィールド | 型 | デフォルト | 意味 |
| --- | --- | --- | --- |
| `org` | `str` | `''` | テナント（ID タプルの最初の要素）。 |
| `part` | `Literal['skill', 'reference', 'all']` | `'skill'` | 返す部分。`skill`（ループとルール。デフォルト）、`reference`（各プレーン）、または `all`。 |

| 出力フィールド | 型 | 意味 |
| --- | --- | --- |
| `version` | `str` | ガイドのバージョン（skills/loom/SKILL.md の `metadata.version`）。 |
| `part` | `Literal['skill', 'reference', 'all']` | 要求どおりに返された部分。 |
| `text` | `str` | Markdown 形式のガイド。スキルのフロントマターは含みません。 |

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