본문으로 건너뛰기
ClickHouse Loom
Esc
↑↓이동↵열기⌘J미리보기
이 페이지에서

`assistant` 연산

이 페이지는 영어 원문을 기계 번역한 것이며, 영어 원문이 기준입니다. Machine-translated from the English page, which is authoritative.

각 assistant.* 연산이 받고 반환하는 정확한 필드입니다.

모든 연산은 HTTP에서는 POST /v1/<op>이고 MCP에서는 loom_<op> 도구입니다. 식별 필드(org, namespace, agent, user_id, session_id)는 전송 방식이 지원하면 토큰과 MCP 세션에서 채워집니다. 단일 사용자 서버에서 토큰 없이 HTTP로 호출하는 경우에는 code.*와 tracker.*를 제외한 모든 연산에서 설치 환경의 org가 사용되며(이 둘은 각자의 plane 값을 유지합니다), 일부 연산에서는 네임스페이스와 에이전트도 채워집니다. 자세한 내용은 식별자와 네임스페이스를 참고하세요. 연산 색인은 role, kind, MCP all 목록을 설명합니다. 알 수 없는 입력 필드도 처리되며 ignored_args에 이름이 표시됩니다.

assistant.ask

이 네임스페이스에 대해 Loom 어시스턴트에게 질문 하나를 하고, 인용이 포함된 답변 하나를 받습니다. 네임스페이스에 무엇이 들어 있는지, 어떻게 사용되는지, 행의 개수, 그리고 더 잘 기록하는 방법을 물을 수 있습니다.

POST /v1/assistant.ask · MCP loom_assistant_ask · role viewer · write · MCP all 툴셋에는 나열되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(식별 튜플의 첫 번째 요소)입니다.
namespace str 필수 연산이 읽거나 쓰는 네임스페이스입니다.
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] 답변에서 백틱으로 쓴 연산 이름과, 답변 어디에든 나오는 LOOM_* 이름 중 이 빌드가 제공하지도 문서화하지도 않는 것으로, 답변이 지어냈을 수 있는 이름입니다.

이 페이지가 도움이 되었나요?