> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Lens용 OpenTelemetry 의미 규칙

> Agent Lens가 에이전트에서 받기를 기대하는 OpenTelemetry GenAI span 구조와 속성입니다.

이 문서는 공식 [OpenTelemetry GenAI Semantic Conventions](https://github.com/open-telemetry/semantic-conventions-genai)에 Agent Lens 전용 규칙과 권장 사항을 더해 확장합니다. 업스트림에서 MAY 또는 SHOULD로 규정한 항목도 이 프로필에서는 대부분 MUST로 규정합니다([RFC 2119](https://www.ietf.org/archive/id/draft-saintandre-2119bis-01.html) 기준). 이 문서에서 별도로 명시하지 않은 사항에는 공식 의미 규칙이 적용됩니다.

## API

OTLP protobuf를 `POST /agents/otel/v1/traces`로 전송하세요. 인증 및 프로젝트 라우팅은 [Agent Lens로 OpenTelemetry 스팬 전송하기](https://docs.coreweave.com/ko/products/agent-lens/get-started/opentelemetry.md)를 참조하세요.

## 체크리스트

Agent Lens가 OTel span을 올바르게 수집하도록 하려면 span이 다음 규칙을 준수하는지 확인하세요.

| 적용 대상 | 규칙 |
| - | - |
| 모든 스팬 | `gen_ai.operation.name`을 반드시 설정해야 하며, [잘 알려진](https://github.com/open-telemetry/semantic-conventions-genai/blob/main/docs/registry/attributes/gen-ai.md#gen-ai-operation-name) 값으로 설정하는 것이 좋습니다 |
| 루트 스팬 | `gen_ai.operation.name`을 반드시 `invoke_agent` 또는 `invoke_workflow`로 설정해야 합니다 |
| 루트 스팬 | `gen_ai.conversation.id`를 반드시 설정해야 하며, `user.id`도 설정하는 것이 좋습니다 |
| 모든 트레이스 | `invoke_agent` 스팬을 하나 이상 반드시 포함해야 합니다 |
| 모든 트레이스 | `parent_id`가 없는 루트 스팬을 반드시 포함해야 합니다 |
| 모든 트레이스 | `gen_ai.input.messages`와 `gen_ai.output.messages`를 설정하는 스팬을 하나 이상 반드시 포함해야 합니다(해당하는 경우 `gen_ai.system_instructions`도 설정하는 것이 좋습니다). |
| [추론 스팬](https://github.com/open-telemetry/semantic-conventions-genai/blob/main/docs/gen-ai/client-inference.md#span-gen_aiclientinference) | 모델에 전송된 전체 컨텍스트를 `gen_ai.input.messages`에, 모델의 전체 응답을 `gen_ai.output.messages`에 반드시 포함해야 합니다(해당하는 경우 `gen_ai.system_instructions`도 설정하는 것이 좋습니다) |
| [추론 스팬](https://github.com/open-telemetry/semantic-conventions-genai/blob/main/docs/gen-ai/client-inference.md#span-gen_aiclientinference) | `gen_ai.response.model`을 반드시 설정해야 하며, `gen_ai.provider.name`도 설정하는 것이 좋습니다 |
| [추론 스팬](https://github.com/open-telemetry/semantic-conventions-genai/blob/main/docs/gen-ai/client-inference.md#span-gen_aiclientinference) | `gen_ai.operation.name`을 `chat`, `generate_content` 또는 `text_completion`으로 설정하는 것이 좋습니다 |
| [추론 스팬](https://github.com/open-telemetry/semantic-conventions-genai/blob/main/docs/gen-ai/client-inference.md#span-gen_aiclientinference) | 관련된 모든 `gen_ai.usage` 속성을 설정하는 것이 좋습니다 |
| [도구 실행 스팬](https://github.com/open-telemetry/semantic-conventions-genai/blob/main/docs/gen-ai/gen-ai-agent-spans.md#execute-tool-span) | `gen_ai.tool.call.id`를 반드시 설정해야 하며, 이 값은 대응하는 `tool_call` 요청 메시지 및 `tool_call_response` 메시지와 반드시 일치해야 합니다. |
| 실패한 스팬 | 상태를 `ERROR`로 설정하고 `error.type`을 반드시 설정해야 합니다. |

## Agent Lens 데이터 모델 매핑

다음 속성은 Agent Lens가 저장하고 노출합니다. 이 목록에 모든 속성이 포함된 것은 아니며, 실제 폴백 로직은 여기에 설명된 것보다 더 복잡할 수 있습니다. 레거시 속성 및 사용 중단된 속성(OpenInference 포함)은 best-effort 방식으로 지원됩니다.

| Agent Lens 필드 | OTel 소스 | 폴백 소스 |
| - | - | - |
| `operation_name` | `gen_ai.operation.name` | `openinference.span.kind` |
| `conversation_id` | `gen_ai.conversation.id` | `conversation.id`, `session.id` |
| `user_id` | `user.id` | `enduser.id`, `enduser.pseudo.id`, `user.hash` |
| `user_email` | `user.email` | |
| `status_code` | OTel span 상태(속성 아님) | |
| `status_message` | OTel span 상태(속성 아님) | |
| `error_type` | `error.type` | |
| `provider_name` | `gen_ai.provider.name` | `gen_ai.system`, `llm.provider`, `llm.system` |
| `agent_name` | `gen_ai.agent.name` | `agent.name` |
| `agent_version` | `gen_ai.agent.version` | |
| `request_model` | `gen_ai.request.model` | `gen_ai.response.model`, `llm.request.model_name`, `embedding.model_name`, `llm.invocation_parameters.model`, `llm.model_name` |
| `response_model` | `gen_ai.response.model` | `gen_ai.request.model`, `llm.response.model_name`, `llm.model_name` |
| `input_messages` | `gen_ai.input.messages` | `gen_ai.prompt`, `llm.input_messages`, `llm.prompts.N.prompt.text`, `input.value` |
| `output_messages` | `gen_ai.output.messages` | `gen_ai.completion`, `llm.output_messages`, `llm.choices.N.completion.text`, `output.value` |
| `output_type` | `gen_ai.output.type` | |
| `system_instructions` | `gen_ai.system_instructions` | system 역할 메시지의 텍스트 |
| `finish_reasons` | `gen_ai.response.finish_reasons` | `llm.finish_reason` |
| `tool_call_id` | `gen_ai.tool.call.id` | `tool_call.id`, `tool.id`, `data.tool_call_id` |
| `tool_name` | `gen_ai.tool.name` | `tool.name`, `tool_call.function.name` |
| `tool_definitions` | `gen_ai.tool.definitions` | `llm.tools.N.tool.json_schema` |
| `tool_call_result` | `gen_ai.tool.call.result` | `data.content`, `output.value` |
| `tool_call_arguments` | `gen_ai.tool.call.arguments` | `tool_call.function.arguments`, `input.value` |
| `input_tokens` | `gen_ai.usage.input_tokens` | `llm.token_count.prompt` |
| `output_tokens` | `gen_ai.usage.output_tokens` | `llm.token_count.completion` |
| `reasoning_tokens` | `gen_ai.usage.reasoning.output_tokens` | `gen_ai.usage.reasoning_tokens`, `gen_ai.usage.experimental.reasoning_tokens`, `llm.token_count.completion_details.reasoning` |
| `cache_creation_input_tokens` | `gen_ai.usage.cache_write.input_tokens` | `gen_ai.usage.cache_creation.input_tokens`, `llm.token_count.prompt_details.cache_write` |
| `cache_read_input_tokens` | `gen_ai.usage.cache_read.input_tokens` | `gen_ai.usage.prompt_tokens_details.cached_tokens`, `gen_ai.usage.input_tokens_details.cached_tokens`, `prompt_tokens_details.cached_tokens`, `llm.token_count.prompt_details.cache_read`, `llm.token_count.prompt_details.cache_input` |

## 특수 GenAI 오퍼레이션 이름

모든 span은 반드시 `gen_ai.operation.name`을 설정해야 합니다. 이 값으로는 [공식 OTel 의미 규칙](https://github.com/open-telemetry/semantic-conventions-genai/blob/main/docs/registry/attributes/gen-ai.md#gen-ai-operation-name)에 정의된 잘 알려진 이름을 사용하는 것이 좋습니다. 다음 오퍼레이션 이름은 Agent Lens에서 특별하게 처리됩니다. 이 오퍼레이션들은 대부분의 에이전트형 워크플로를 기술하는 데 필요한 최소한의 오퍼레이션입니다.

| 오퍼레이션 이름 | 의미 | 특수 용도 |
| - | - | - |
| [`invoke_agent`](https://github.com/open-telemetry/semantic-conventions-genai/blob/main/docs/gen-ai/gen-ai-agent-spans.md#invoke-agent-client-span), [`invoke_workflow`](https://github.com/open-telemetry/semantic-conventions-genai/blob/main/docs/gen-ai/gen-ai-agent-spans.md#invoke-workflow-span) | 턴 1개 | 턴 전체의 대화 ID와 사용자 ID를 결정합니다. |
| [추론 스팬](https://github.com/open-telemetry/semantic-conventions-genai/blob/main/docs/gen-ai/client-inference.md#span-gen_aiclientinference) (`chat`, `generate_content`, `text_completion`) | 모델 요청 1개 | 채팅 이력의 입력 및 출력 메시지를 결정합니다. 토큰 사용량 및 비용 데이터를 결정합니다. |
| [`execute_tool`](https://github.com/open-telemetry/semantic-conventions-genai/blob/main/docs/gen-ai/gen-ai-spans.md#execute-tool-span) | 애플리케이션이 수행한 도구 실행 1건 | `tool_call` 요청을 `tool_call_response` 메시지와 연결합니다. |

## 사용자 지정 속성

Agent Lens는 벤더별 속성 이름과 사용자 정의 속성 이름을 허용하며, 이를 사용자 지정 속성으로 사용할 수 있도록 제공합니다. 예를 들면 `my_company.user.is_admin=true`, `my_company.user.sentiment="positive"`, `my_company.eval.score=0.5`와 같습니다.

* 사용자 지정 속성 값은 반드시(MUST) 정수, 부동소수점, 문자열 또는 불리언 값이어야 합니다.
* 사용자 지정 속성 이름은 반드시(MUST) 카디널리티가 낮아야 하며, 동적으로 생성해서는 안 됩니다(MUST NOT).
* 사용자 지정 속성 이름에는 `my_company.*`와 같이 일관된 namespace를 사용해야 합니다(SHOULD).

## OTel 스팬 및 속성

이 섹션은 공식 OTel 의미 규칙의 [에이전트 span](https://github.com/open-telemetry/semantic-conventions-genai/blob/main/docs/gen-ai/gen-ai-agent-spans.md#spans) 및 [추론 스팬](https://github.com/open-telemetry/semantic-conventions-genai/blob/main/docs/gen-ai/client-inference.md)의 구조를 따르되, 이 프로필이 공식 규칙과 다른 부분만 나열합니다. span 이름, span 종류, 여기에 나열되지 않은 스팬을 비롯한 나머지 항목은 모두 공식 가이드라인을 따릅니다.

### [Invoke workflow span](https://github.com/open-telemetry/semantic-conventions-genai/blob/main/docs/gen-ai/gen-ai-agent-spans.md#invoke-workflow-span)

Agent Lens에서 루트 span은 반드시 `invoke_workflow` 또는 `invoke_agent` 중 하나여야 합니다. 사용자가 여러 에이전트를 한 번에 호출할 수 있는 복잡한 경우에는 `invoke_workflow`를 사용하세요. 그 외의 경우에는 `invoke_agent`를 사용하는 것이 좋습니다.

| 속성 | 요구 수준 | 참고 사항 | 예시 값 |
| - | - | - | - |
| `gen_ai.operation.name` | 필수 | | `invoke_workflow` |
| `gen_ai.conversation.id` | 필수 | | `conv_5j66UpCpwteGg4YSxUnt7lPY` |
| `user.id` | 권장 | 턴을 시작한 사용자의 ID입니다. | `usr_8kscj` |
| `user.email` | 선택 사항 | 이 턴을 시작한 사용자의 이메일입니다. | `user@domain.com` |
| `gen_ai.agent.name` | 권장 | 에이전트의 고정 이름입니다. 버전 정보를 포함하지 않아야 합니다(SHOULD NOT). | `Math Tutor`; `Fiction Writer` |
| `gen_ai.agent.version` | 권장 | | `1.0.0`; `2025-05-01` |
| `gen_ai.input.messages` | 권장 | 이 호출을 트리거한 입력입니다. 이전 턴의 이력이나 시스템 지침을 포함해서는 안 됩니다(MUST NOT). | `[{"role": "user", "parts": [{"type": "text", "content": "Summarize GPU news"}]}]` |
| `gen_ai.output.messages` | 권장 | 워크플로가 사용자에게 반환하는 최종 응답입니다. 여러 에이전트가 병렬로 실행되는 경우에는 사용자에게 표시되는 통합 결과를 의미합니다. | `[{"role": "assistant", "parts": [{"type": "text", "content": "GPU prices fell 8% this week."}]}]` |

### [에이전트 호출 span](https://github.com/open-telemetry/semantic-conventions-genai/blob/main/docs/gen-ai/gen-ai-agent-spans.md#invoke-agent-client-span)

Agent Lens에서 루트 span은 반드시(MUST) `invoke_workflow` 또는 `invoke_agent` 중 하나여야 합니다. 사용자가 여러 에이전트를 한 번에 호출할 수 있는 복잡한 경우에는 `invoke_workflow`를 사용하세요. 그 밖의 경우에는 `invoke_agent`를 사용하는 것이 좋습니다.

| 속성 | 요구 수준 | 참고 사항 | 예시 값 |
| - | - | - | - |
| `gen_ai.operation.name` | 필수 | | `invoke_agent` |
| `gen_ai.conversation.id` | 필수 | | `conv_5j66UpCpwteGg4YSxUnt7lPY` |
| `user.id` | 권장 | 해당 턴을 시작한 사용자의 ID입니다. | `usr_8kscj` |
| `user.email` | 선택 사항 | 해당 턴을 시작한 사용자의 이메일입니다. | `user@domain.com` |
| `gen_ai.agent.name` | 권장 | 변하지 않는 에이전트 고유 이름입니다. 버전 정보는 포함하지 않아야 합니다(SHOULD NOT). | `Math Tutor`; `Fiction Writer` |
| `gen_ai.agent.version` | 권장 | | `1.0.0`; `2025-05-01` |
| `gen_ai.input.messages` | 권장 | 이 호출을 트리거한 입력입니다. 이전 턴의 이력이나 시스템 지침을 포함해서는 안 됩니다(MUST NOT). | `[{"role": "user", "parts": [{"type": "text", "content": "Where is order 12?"}]}]` |
| `gen_ai.output.messages` | 권장 | 에이전트의 최종 응답으로, 어시스턴트 메시지 형식입니다. 중간 단계의 도구 호출이나 모델 출력을 포함해서는 안 됩니다(MUST NOT). | `[{"role": "assistant", "parts": [{"type": "text", "content": "It shipped yesterday."}]}]` |

### 추론 span

Agent Lens는 [추론 span](https://github.com/open-telemetry/semantic-conventions-genai/blob/main/docs/gen-ai/client-inference.md#span-gen_aiclientinference)을 사용하여 대화의 메시지 이력을 구축하고 비용을 추정합니다. 추론 span에는 도구 Call 요청과 응답도 담깁니다. 모델이 도구 Call을 통해 최종 응답을 보내는 경우, 해당 도구 이름은 반드시 `final_answer`, `final_result`, `set_model_response`, `send_message` 중 하나여야 합니다.

| 속성 | 요구 수준 | 참고 사항 | 예시 값 |
| - | - | - | - |
| `gen_ai.operation.name` | 필수 | | `chat`, `generate_content`, `text_completion` |
| `user.id` | 권장 | 턴을 시작한 사용자의 ID입니다. | `usr_8kscj` |
| `user.email` | 선택 | 턴을 시작한 사용자의 이메일입니다. | `user@domain.com` |
| `gen_ai.agent.name` | 권장 | 에이전트의 고정 이름입니다. 버전 정보를 포함하지 않아야 합니다(SHOULD NOT). | `Math Tutor`; `Fiction Writer` |
| `gen_ai.agent.version` | 권장 | | `1.0.0`; `2025-05-01` |
| `gen_ai.provider.name` | 권장 | | |
| `gen_ai.response.model` | 필수 | 공급자가 반환한 정확한 모델 ID로, 비용 추정에 사용됩니다. | `gpt-4-0613` |
| `gen_ai.response.finish_reasons` | 권장 | 출력 메시지마다 항목을 하나씩 `gen_ai.output.messages`와 같은 순서로 지정합니다. | `["stop", "length", "error"]` |
| `gen_ai.input.messages` | 필수 | 가장 최근 프롬프트뿐 아니라 모델에 전송된 전체 컨텍스트를 포함하세요. | `[{"role": "user", "parts": [{"type": "text", "content": "Weather in Paris?"}]}, {"role": "assistant", "parts": [{"type": "tool_call", "id": "call_VSPygqKTWdrhaFErNvMV18Yl", "name": "get_weather", "arguments": {"location": "Paris"}}]}, {"role": "tool", "parts": [{"type": "tool_call_response", "id": "call_VSPygqKTWdrhaFErNvMV18Yl", "response": "rainy, 57°F"}]}]` |
| `gen_ai.output.messages` | 필수 | | `[{"role": "assistant", "parts": [{"type": "text", "content": "The weather in Paris is currently rainy with a temperature of 57°F."}]}]` |
| `gen_ai.system_instructions` | 권장 | | `[{"type": "text", "content": "You are an Agent that greet users, always use greetings tool to respond"}]` |
| `gen_ai.usage.input_tokens` | 필수 | 캐시 읽기 및 쓰기 토큰이 있다면 반드시 포함해야 합니다(MUST). | |
| `gen_ai.usage.output_tokens` | 필수 | 추론 토큰이 있다면 반드시 포함해야 합니다(MUST). | |

#### 토큰 사용량 및 비용

Agent Lens는 각 추론 span의 토큰 사용량과 `gen_ai.response.model`을 기반으로 비용을 추정합니다.

* `gen_ai.usage.input_tokens`는 캐시된 토큰을 포함한 전체 입력이어야 합니다(MUST). 캐시 읽기 및 쓰기는 `gen_ai.usage.cache_read.input_tokens`와 `gen_ai.usage.cache_write.input_tokens`에도 기록해야 합니다(SHOULD). Agent Lens는 이 값을 전체에서 뺀 다음 각각의 단가를 적용해 비용을 계산합니다. `gen_ai.usage.input_tokens`에 캐시되지 않은 토큰만 집계되면 입력이 실제보다 적게 집계되어 비용이 음수로 표시될 수 있습니다.
* `gen_ai.usage.output_tokens`는 추론 토큰을 포함한 전체 출력이어야 합니다(MUST).
* 일부 공급자는 이러한 수치를 따로 보고하므로, 이를 합계에 다시 더하세요. Anthropic은 캐시된 토큰을 입력 토큰과 따로 보고하고, Gemini는 thinking 토큰을 출력 토큰과 따로 보고합니다. OpenAI는 캐시된 토큰을 입력 수치에, 추론 토큰을 출력 수치에 이미 포함합니다.
* `gen_ai.response.model`은 공급자가 반환한 정확한 모델 ID여야 합니다(MUST). `opus`나 `sonnet` 같은 별칭에는 가격 정보가 없으므로 해당 Call에 `Cost -`가 표시됩니다.
* 사용량 속성은 추론 span에만 설정해야 합니다(SHOULD). 턴의 합계를 해당 턴의 `invoke_agent` span에 복사하지 마세요.

### 도구 실행 span

[도구 Call](https://github.com/open-telemetry/semantic-conventions-genai/blob/main/docs/gen-ai/gen-ai-agent-spans.md#execute-tool-span)은 모델이 애플리케이션에 함수 실행을 요청할 때 발생합니다. 하나의 도구 Call은 세 개의 스팬에 걸쳐 나타나며, Agent Lens가 이들을 연결할 수 있도록 계측 코드는 각 스팬에 동일한 gen\_ai.tool.call.id를 기록해야 합니다.

1. 모델이 호출을 요청하는 추론 span입니다. gen\_ai.output.messages에 tool\_call 구성 요소로 기록됩니다.
2. 함수 실행을 나타내는 execute\_tool span입니다.
3. 결과를 모델에 반환하는 다음 추론 span입니다. gen\_ai.input.messages에 tool\_call\_response 구성 요소로 기록됩니다.

요청, 실행, 응답 구성 요소는 모두 동일한 `gen_ai.tool.call.id`로 연결되어야 하며(MUST), 이 ID는 트레이스 내에서 고유해야 합니다(MUST).

| 속성 | 요구 수준 | 참고 사항 | 예시 값 |
| - | - | - | - |
| `gen_ai.operation.name` | 필수 | | `execute_tool` |
| `user.id` | 권장 | 턴을 시작한 사용자의 ID입니다. | `usr_8kscj` |
| `user.email` | 선택 | 턴을 시작한 사용자의 이메일입니다. | `user@domain.com` |
| `gen_ai.agent.name` | 권장 | 에이전트의 고정 이름입니다. 버전 정보를 포함하지 않아야 합니다(SHOULD NOT). | `Math Tutor`; `Fiction Writer` |
| `gen_ai.agent.version` | 권장 | | `1.0.0`; `2025-05-01` |
| `gen_ai.tool.call.id` | 필수 | 대응하는 `tool_call` 및 `tool_call_response` 메시지의 ID와 일치해야 합니다(MUST). | `call_mszuSIzqtI65i1wAUOE8w5H4` |
| `gen_ai.tool.call.arguments` | 필수 | | `{"location": "San Francisco?", "date": "2025-10-01"}` |
| `gen_ai.tool.call.result` | 권장 | | `{"temperature_range": {"high": 75, "low": 60}, "conditions": "sunny"}` |

## 예시

### 에이전트가 도구를 사용해 질문에 답변하는 예

```plaintext theme={"system"}
// 턴: 사용자의 질문과 에이전트의 답변.
invoke_agent support-bot  conversation=conv_1  user=u_42
  in:   user "Where is order 12?"
  out:  assistant "It shipped."

  // 모델이 도구 Call을 요청합니다. 이 Call은 call_1로 식별됩니다.
  chat claude-sonnet-5-5  provider=anthropic
    in:   user "Where is order 12?"
    out:  assistant call get_order[call_1] {"order_id": "12"}  finish=tool_call

  // 애플리케이션이 동일한 호출 ID로 도구를 실행합니다.
  execute_tool get_order  call=call_1
    args:    {"order_id": "12"}
    result:  "shipped"

  // 다음 모델 Call은 도구 결과를 포함한 전체 컨텍스트를 참조합니다.
  chat claude-sonnet-5-5  provider=anthropic
    in:   ...
          tool result[call_1] "shipped"
    out:  assistant "It shipped."  finish=stop
```

### 에이전트가 하위 에이전트를 도구로 호출하는 경우

```plaintext theme={"system"}
// 턴: 사용자의 질문과 최종 답변입니다.
invoke_agent triage  conversation=conv_3  user=u_42
  in:   user "Was I double charged?"
  out:  assistant "Yes, one charge was a duplicate."

  // 상위 에이전트의 모델이 하위 에이전트를 도구로 호출하여 작업을 위임합니다.
  chat claude-sonnet-5-5  provider=anthropic
    in:   user "Was I double charged?"
    out:  assistant call billing_agent[call_2] {"task": "Check account 88"}  finish=tool_call

  // 도구 실행 결과는 하위 에이전트의 답변입니다.
  execute_tool billing_agent  call=call_2
    args:    {"task": "Check account 88"}
    result:  "Yes, one duplicate."

    // 하위 에이전트는 자신에게 전달된 작업만 볼 수 있습니다.
    invoke_agent billing
      in:   user "Check account 88"
      out:  assistant "Yes, one duplicate."

  // 상위 에이전트의 모델은 답변을 도구 결과로 돌려받아 응답합니다.
  chat claude-sonnet-5-5  provider=anthropic
    in:   ...
          tool result[call_2] "Yes, one duplicate."
    out:  assistant "Yes, one charge was a duplicate."  finish=stop
```

### 워크플로에서 두 에이전트를 병렬로 실행

```plaintext theme={"system"}
// 턴: 두 에이전트를 병렬로 실행하고 각 응답을 합치는 워크플로입니다.
invoke_workflow news-pipeline  conversation=conv_2  user=u_42
  in:   user "Summarize GPU and CPU news"
  out:  assistant "GPU prices fell 8% this week, and CPU prices held steady."

  // 두 에이전트는 함께 시작하며, 각 에이전트는 자신의 작업만 받습니다.
  invoke_agent gpu-researcher
    in:   user "Find GPU pricing news"
    out:  assistant "GPU prices fell 8%."

  // 같은 부모 아래의 형제이며, 시작 시간과 종료 시간이 겹칩니다.
  invoke_agent cpu-researcher
    in:   user "Find CPU pricing news"
    out:  assistant "CPU prices held steady."
```

### 에이전트가 이미지를 생성하는 경우

```plaintext theme={"system"}
// 턴: 에이전트가 이미지로 응답합니다.
invoke_agent designer  conversation=conv_6  user=u_42
  in:   user "Draw a coffee shop logo"
  out:  assistant [image/png blob]

  // 이미지는 modality가 설정된 블롭 파트로 인라인 전송됩니다.
  generate_content gemini-2.5-flash-image  provider=gcp.gemini
    in:   user "Draw a coffee shop logo"
    out:  assistant [image/png blob]  finish=stop
```

### 실패하는 도구 Call

```plaintext theme={"system"}
// 에이전트가 복구되었으므로 턴에 오류 상태가 없습니다.
invoke_agent support-bot  conversation=conv_7  user=u_42
  in:   user "Where is order 34?"
  out:  assistant "The order system is down. Try again soon."

  // 모델이 도구 Call을 요청합니다.
  chat claude-sonnet-5-5  provider=anthropic
    in:   user "Where is order 34?"
    out:  assistant call get_order[call_4] {"id": "34"}  finish=tool_call

  // 도구에서 timeout이 발생합니다. 상태는 ERROR이고 error.type이 설정되며, 결과는 없습니다.
  execute_tool get_order  call=call_4  status=ERROR(TimeoutError)
    args:    {"id": "34"}

  // 오류는 도구 결과로 모델에 다시 전달되고, 모델이 응답합니다.
  chat claude-sonnet-5-5  provider=anthropic
    in:   ...
          tool result[call_4] "Error: timed out"
    out:  assistant "The order system is down. Try again soon."  finish=stop
```
