RunSessionResponse

SessionService.RunSession의 응답 메시지입니다.

JSON 표현
{
  "outputs": [
    {
      object (SessionOutput)
    }
  ]
}
필드
outputs[]

object (SessionOutput)

세션의 출력입니다.

SessionOutput

세션의 출력입니다.

JSON 표현
{
  "turnIndex": integer,
  "turnCompleted": boolean,
  "diagnosticInfo": {
    object (SessionOutput.DiagnosticInfo)
  },
  "context": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ],

  // Union field output_type can be only one of the following:
  "text": string,
  "audio": string,
  "toolCalls": {
    object (ToolCalls)
  },
  "citations": {
    object (Citations)
  },
  "googleSearchSuggestions": {
    object (GoogleSearchSuggestions)
  },
  "endSession": {
    object (EndSession)
  },
  "payload": {
    object
  },
  "image": {
    object (Image)
  }
  // End of list of possible types for union field output_type.
}
필드
turnIndex

integer

이 출력이 속한 대화 턴의 순차적 순서를 1부터 나타냅니다.

turnCompleted

boolean

true이면 CES 에이전트가 현재 대화 턴의 끝을 감지했으며 이 턴에 더 이상 출력을 제공하지 않습니다.

diagnosticInfo

object (SessionOutput.DiagnosticInfo)

선택사항입니다. 진단 정보에는 입력 처리 중에 실행 세부정보가 포함됩니다. 각 턴의 마지막 SessionOutput (turnCompleted=true)에만 채워집니다.

context[]

object

외부 감독 가드레일의 컨텍스트 메시지입니다.

임의 유형의 필드를 포함하는 객체입니다. 추가 필드 "@type"은 유형을 식별하는 URI를 포함합니다. 예: { "id": 1234, "@type": "types.example.com/standard/id" }

통합 필드 output_type. 출력 유형입니다. output_type은 다음 중 하나여야 합니다.
text

string

CES 에이전트의 출력 텍스트입니다.

audio

string (bytes format)

CES 에이전트의 오디오 출력입니다.

base64 인코딩 문자열입니다.

toolCalls

object (ToolCalls)

클라이언트가 도구를 실행하도록 요청합니다.

citations

object (Citations)

에이전트가 생성한 텍스트의 소스 정보를 제공하는 인용입니다.

googleSearchSuggestions

object (GoogleSearchSuggestions)

GoogleSearchTool을 호출한 결과로 Google 검색에서 반환된 추천입니다.

endSession

object (EndSession)

세션이 종료되었음을 나타냅니다.

payload

object (Struct format)

CES 에이전트의 구조화된 출력이 포함된 맞춤 페이로드입니다.

image

object (Image)

CES 에이전트의 출력 이미지입니다.

ToolCalls

클라이언트가 도구를 실행하고 세션을 계속하기 전에 실행 결과를 반환하도록 요청합니다.

JSON 표현
{
  "toolCalls": [
    {
      object (ToolCall)
    }
  ]
}
필드
toolCalls[]

object (ToolCall)

선택사항입니다. 실행할 도구 호출 목록입니다.

EndSession

세션이 성공적으로 완료되었거나 (예: 사용자가 '안녕!'이라고 말함) 에이전트 에스컬레이션으로 인해 세션이 종료되었음을 나타냅니다.

세션이 종료된 후에는 에이전트가 더 이상 입력을 처리하지 않으며 클라이언트는 에이전트로부터 남은 응답을 모두 받은 후 절반을 닫고 연결을 끊어야 합니다.

JSON 표현
{
  "metadata": {
    object
  }
}
필드
metadata

object (Struct format)

선택사항입니다. 세션 종료 신호에 대한 추가 정보(예: 세션 종료 이유)를 제공합니다.

SessionOutput.DiagnosticInfo

처리 중에 실행 세부정보가 포함됩니다.

JSON 표현
{
  "messages": [
    {
      object (Message)
    }
  ],
  "rootSpan": {
    object (Span)
  }
}
필드
messages[]

object (Message)

처리 중에 발생한 메시지 목록입니다.

rootSpan

object (Span)

전체 요청 처리의 트레이스로, 루트 스팬으로 표시됩니다. 이 스팬에는 특정 작업의 중첩된 하위 스팬이 포함될 수 있습니다.