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

# Genai 대화 span



## OpenAPI

````yaml /ko/weave/reference/service-api/openapi.json post /agents/conversations/spans
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers: []
security: []
paths:
  /agents/conversations/spans:
    post:
      tags:
        - Agents
      summary: Genai 대화 span
      operationId: genai_conversation_spans_agents_conversations_spans_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentConversationSpansReq'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentConversationSpansRes'
          description: 성공 응답
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: 검증 오류
components:
  schemas:
    AgentConversationSpansReq:
      description: |-
        명시적으로 지정한 대화 집합의 span 시퀀스를 요청합니다.

        주어진 `conversation_ids`에 대해 span 스칼라 column만 읽고(메시지 본문 제외),
        대화 목록 span 미니맵을 구동합니다.
      properties:
        conversation_ids:
          items:
            type: string
          maxItems: 10000
          title: Conversation Ids
          type: array
        project_id:
          title: Project Id
          type: string
        started_after:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Started After
        started_before:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Started Before
      required:
        - project_id
      title: AgentConversationSpansReq
      type: object
    AgentConversationSpansRes:
      description: 요청된 각 대화마다 하나씩 있는 span 시퀀스 + 피드백 마커 항목입니다.
      properties:
        conversations:
          items:
            $ref: '#/components/schemas/AgentConversationSpans'
          title: Conversations
          type: array
      title: AgentConversationSpansRes
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    AgentConversationSpans:
      description: 한 대화의 span 시퀀스와 해당 피드백 마커입니다.
      properties:
        conversation_id:
          title: Conversation Id
          type: string
        spans:
          items:
            $ref: '#/components/schemas/AgentConversationSpan'
          title: Spans
          type: array
        spans_feedback:
          items:
            $ref: '#/components/schemas/AgentConversationSpanFeedback'
          title: Spans Feedback
          type: array
      required:
        - conversation_id
      title: AgentConversationSpans
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
    AgentConversationSpan:
      description: |-
        대화의 트레이스에 있는 span 하나입니다.

        `agent_conversation_spans`에서 반환되며, span 스칼라 column만 읽고
        메시지 본문은 포함하지 않습니다. span은 `started_at` 순으로 정렬되며,
        이는 상세 chat 뷰의 부모/자식 트리 순회 순서와 비슷하지만 정확히
        일치하지는 않습니다. `operation_name`은 원시 OTel 값이며,
        클라이언트가 이를 표시 범주로 매핑합니다.
      properties:
        duration_ms:
          title: Duration Ms
          type: integer
        operation_name:
          title: Operation Name
          type: string
        span_id:
          title: Span Id
          type: string
        status:
          enum:
            - UNSET
            - OK
            - ERROR
          title: Status
          type: string
        trace_id:
          title: Trace Id
          type: string
      required:
        - operation_name
        - trace_id
        - span_id
        - status
        - duration_ms
      title: AgentConversationSpan
      type: object
    AgentConversationSpanFeedback:
      description: |-
        대화의 턴(또는 대화 자체)에 적용된 tags 및 평점입니다.

        클라이언트 측에서 `trace_id`(턴)를 span과 매칭해 배치하며,
        대화 수준 피드백의 경우 `trace_id`는 None입니다.
      properties:
        feedback_type:
          enum:
            - wandb.agent_user_feedback
            - wandb.agent_monitor
          title: Feedback Type
          type: string
        ratings:
          description: 이 피드백에 적용된 숫자 Scorer 평점입니다.
          items:
            $ref: '#/components/schemas/AgentConversationSpanRating'
          title: Ratings
          type: array
        tags:
          description: 이 피드백에 적용된 임의의 설명용 tags입니다.
          examples:
            - - 👍
              - needs-review
          items:
            type: string
          title: Tags
          type: array
        trace_id:
          anyOf:
            - type: string
            - type: 'null'
          description: 이 피드백이 연결되는 턴입니다. 대화 수준이면 None입니다.
          title: Trace Id
      required:
        - trace_id
        - feedback_type
      title: AgentConversationSpanFeedback
      type: object
    AgentConversationSpanRating:
      description: 턴 또는 대화에 적용된 숫자 평점(Scorer 점수) 하나입니다.
      properties:
        confidence:
          anyOf:
            - type: number
            - type: 'null'
          title: Confidence
        name:
          title: Name
          type: string
        reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Reason
        value:
          title: Value
          type: number
      required:
        - name
        - value
      title: AgentConversationSpanRating
      type: object

````