> Source: https://clickhouse.github.io/loom/ko/reference/operations/assistant/ (Markdown: https://clickhouse.github.io/loom/ko/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>`입니다. 신원 필드(`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)에서는 네임스페이스와 에이전트도 채워집니다. 자세한 내용은 [신원과 네임스페이스](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md)를 참고하세요. [연산 색인](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md)에서 역할, 종류, MCP `all` 목록을 설명합니다. 알 수 없는 입력 필드도 처리되며 `ignored_args`에 이름이 표시됩니다.

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

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

## `assistant.ask`

Loom 어시스턴트에게 이 네임스페이스에 대해 질문 하나를 하고, 출처가 달린 답변 하나를 받습니다. 네임스페이스에 무엇이 들어 있는지, 어떻게 쓰이는지, 행의 개수, 더 잘 기록하는 방법을 물을 수 있습니다.

`POST /v1/assistant.ask` · MCP `loom_assistant_ask` · 역할 `viewer` · 쓰기 · MCP `all` 도구 세트에 나열되지 않음

| 입력 필드 | 타입 | 기본값 | 의미 |
| --- | --- | --- | --- |
| `org` | `str` | 필수 | 테넌트(신원 튜플의 첫 번째 요소). |
| `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 -->
