Skip to main content
tracing 모듈을 통해 다음 항목에 액세스하세요.

메시지

대화에 포함된 단일 메시지입니다. 두 가지 생성 방식을 지원합니다.
  1. 플랫 방식(하위 호환용, 일반 텍스트에 사용하기 편리함): Message(role="assistant", content="Hi there")
  2. 명시적 파트 방식(표현력이 더 풍부함, 도구 Call, 추론과 텍스트 혼합, 인라인 미디어 지원): Message(role="assistant", parts=[TextPart(content="Let me check"), ToolCallPart(id="c1", name="get_weather", arguments='{...}')])
parts가 비어 있지 않으면 parts가 정식 표현이 됩니다. 비어 있으면 직렬화기가 플랫 필드를 바탕으로 단일 TextPart(role="tool"인 경우에는 ToolCallResponsePart)를 합성합니다. Message는 Pydantic 모델입니다. 생성할 때 아래 필드를 키워드 인수로 설정하세요. 필드

Message.user

일반 텍스트로 사용자 메시지를 생성합니다.

Message.system

일반 텍스트로 시스템 메시지를 생성합니다.

Message.assistant

선택적 텍스트와 도구 Call을 포함하는 assistant 메시지를 구축합니다. 단순한 응답에는 일반 텍스트를 사용하고, assistant가 하나 이상의 도구를 요청하는 경우에는 tool_calls를 전달하세요. 둘 다 있으면 텍스트가 맨 앞의 TextPart로 출력되고 그 뒤에 각 ToolCallPart가 이어지므로 채팅 뷰에서 이들이 인라인으로 렌더링됩니다.

Message.tool_result

이전에 요청된 도구 Call에 대한 도구 결과 메시지를 생성합니다. output은 string, dict, list, 스칼라 또는 None일 수 있으며, 내부의 ToolCallResponsePart가 string이 아닌 값을 JSON으로 인코딩합니다.

MessagePart

TextPart

일반 텍스트 콘텐츠 파트입니다. TextPart는 Pydantic 모델입니다. 생성할 때 아래 필드 중 원하는 필드를 키워드 인수로 설정할 수 있습니다. 필드

ReasoningPart

추론 / chain-of-thought 콘텐츠 파트입니다. ReasoningPart는 Pydantic 모델입니다. 인스턴스를 생성할 때 아래 필드 중 원하는 필드를 키워드 인수로 설정하세요. 필드

ToolCallPart

도구 호출을 위한 assistant의 요청입니다. arguments는 전송 시 string입니다(GenAI semconv 기준). JSONString 어노테이션을 사용하면 호출자가 생성 또는 할당 시점에 dict / list / 스칼라 값을 전달할 수 있으며, SDK가 이를 JSON으로 인코딩합니다. 이미 인코딩된 문자열은 변경 없이 그대로 전달됩니다. ToolCallPart는 Pydantic 모델입니다. 생성할 때 아래 필드를 키워드 인수로 지정하세요. 필드

ToolCallResponsePart

이전에 요청된 도구 Call을 실행한 결과입니다. response는 전송 시 string으로 전달됩니다. ToolCallPart.arguments와 마찬가지로 JSONString의 편의 기능을 동일하게 사용할 수 있습니다. ToolCallResponsePart는 Pydantic 모델입니다. 인스턴스를 생성할 때 아래 필드를 키워드 인수로 지정하세요. 필드

BlobPart

인라인 바이너리 콘텐츠입니다(예: base64로 인코딩된 이미지/오디오). BlobPart는 Pydantic 모델입니다. 인스턴스를 생성할 때 아래 필드를 키워드 인수로 지정할 수 있습니다. 필드

UriPart

URI로 미디어 콘텐츠를 참조합니다. UriPart는 Pydantic 모델입니다. 인스턴스를 생성할 때 아래 필드를 키워드 인수로 설정할 수 있습니다. 필드

FilePart

공급자 측 파일 ID로 미디어 콘텐츠를 참조합니다. FilePart는 Pydantic 모델입니다. 인스턴스를 생성할 때 아래 필드를 키워드 인수로 지정할 수 있습니다. 필드

사용법

LLM Call의 토큰 사용량입니다. Usage는 Pydantic 모델입니다. 생성할 때 아래 필드 중 원하는 필드를 키워드 인수로 설정할 수 있습니다. 필드

추론

LLM Call에서 반환된 추론/chain-of-thought 콘텐츠입니다. Reasoning은 Pydantic 모델입니다. 인스턴스를 생성할 때 아래 필드를 키워드 인수로 지정하세요. 필드

MediaAttachment

OTLP GenAI 블롭, URI 또는 공급자 파일 파트로 내보내는 미디어입니다. MediaAttachment는 Pydantic 모델입니다. 인스턴스를 생성할 때 아래 필드를 키워드 인수로 설정할 수 있습니다. 필드
마지막 수정일 2026년 9월 30일