> Source: https://clickhouse.github.io/loom/zh-CN/reference/operations/org/ (Markdown: https://clickhouse.github.io/loom/zh-CN/reference/operations/org.md)

<!-- i18n: source=docs/reference/operations/org.md blob=843f69431376b649f0486ff109484f01fc4767c6 model=claude-sonnet-5-5 -->
> 本页由机器从[英文原文](https://clickhouse.github.io/loom/reference/operations/org/)翻译，内容以英文原文为准。
> Machine-translated from the [English page](https://clickhouse.github.io/loom/reference/operations/org/), which is authoritative.

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

# `org` 操作

每个 `org.*` 操作接受和返回的确切字段。

<!-- 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>`。身份字段（`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)还会使用其命名空间和 agent；参见[身份与命名空间](https://clickhouse.github.io/loom/zh-CN/concepts/identities-and-namespaces/)。[操作索引](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md)说明了角色、类型以及 MCP 的 `all` 列表。未知的输入字段会照常处理，并在 `ignored_args` 中列出。

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

<a id="orgmodel_calls"></a>

## `org.model_calls`

org 的当前设置；若从未设置过，则为已启用且未锁定。

`POST /v1/org.model_calls` · MCP `loom_org_model_calls` · 角色 `org_admin` · 幂等 · 不在 MCP `all` 工具集中列出

| 输入字段 | 类型 | 默认值 | 含义 |
| --- | --- | --- | --- |
| `org` | `str` | 必填 | 租户（身份元组的第一个元素）。 |

| 输出字段 | 类型 | 含义 |
| --- | --- | --- |
| `org` | `str` | 租户（身份元组的第一个元素）。 |
| `enabled` | `bool` | org 的数据是否可以发送给模型；从未设置过时为 true。 |
| `reason` | `str` | 最近一次变更时附带的说明；没有则为 ""。 |
| `updated_by` | `str` | 最近一次变更的操作者；从未设置过时为 ""。 |
| `updated_at` | `datetime \| None` | 设置最近一次变更的时间（UTC），从未设置过时为 None；处于关闭状态时，为关闭的时间，无论之后还有什么其他变更。 |
| `locked` | `bool` | 平台管理员是否锁定了该设置：锁定后其管理员无法将其开启。 |
| `locked_by` | `str` | 设置锁定的平台管理员；未锁定时为 ""。 |

<a id="orgset_model_calls"></a>

## `org.set_model_calls`

关闭或开启 org 的模型调用。

`POST /v1/org.set_model_calls` · MCP `loom_org_set_model_calls` · 角色 `org_admin` · 幂等 · 已审计 · 不在 MCP `all` 工具集中列出

| 输入字段 | 类型 | 默认值 | 含义 |
| --- | --- | --- | --- |
| `org` | `str` | 必填 | 租户（身份元组的第一个元素）。 |
| `enabled` | `bool` | 必填 | false 表示关闭 org 的模型调用；true 表示重新开启。 |
| `reason` | `str` | `''` | 说明原因的备注，与设置一起保存；最多 500 个字符。 |
| `locked` | `bool \| None` | `None` | 仅限平台管理员：true 锁定该设置（org 自己的管理员可以将其关闭，但不能重新开启），false 解除锁定；不设置则保持锁定状态不变。 |

| 输出字段 | 类型 | 含义 |
| --- | --- | --- |
| `org` | `str` | 租户（身份元组的第一个元素）。 |
| `enabled` | `bool` | org 的数据是否可以发送给模型；从未设置过时为 true。 |
| `reason` | `str` | 最近一次变更时附带的说明；没有则为 ""。 |
| `updated_by` | `str` | 最近一次变更的操作者；从未设置过时为 ""。 |
| `updated_at` | `datetime \| None` | 设置最近一次变更的时间（UTC），从未设置过时为 None；处于关闭状态时，为关闭的时间，无论之后还有什么其他变更。 |
| `locked` | `bool` | 平台管理员是否锁定了该设置：锁定后其管理员无法将其开启。 |
| `locked_by` | `str` | 设置锁定的平台管理员；未锁定时为 ""。 |

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