tracing 모듈을 통해 다음 항목에 액세스하세요.
메시지
-
플랫 방식(하위 호환용, 일반 텍스트에 사용하기 편리함):
Message(role="assistant", content="Hi there") -
명시적 파트 방식(표현력이 더 풍부함, 도구 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
tool_calls를 전달하세요. 둘 다 있으면
텍스트가 맨 앞의 TextPart로 출력되고 그 뒤에 각 ToolCallPart가 이어지므로
채팅 뷰에서 이들이 인라인으로 렌더링됩니다.
Message.tool_result
output은 string, dict, list, 스칼라 또는 None일 수 있으며,
내부의 ToolCallResponsePart가 string이 아닌 값을 JSON으로 인코딩합니다.
MessagePart
TextPart
TextPart는 Pydantic 모델입니다. 생성할 때 아래 필드 중 원하는 필드를 키워드 인수로 설정할 수 있습니다.
필드
ReasoningPart
ReasoningPart는 Pydantic 모델입니다. 인스턴스를 생성할 때 아래 필드 중 원하는 필드를 키워드 인수로 설정하세요.
필드
ToolCallPart
arguments는 전송 시 string입니다(GenAI semconv 기준). JSONString
어노테이션을 사용하면 호출자가 생성 또는 할당 시점에 dict / list / 스칼라 값을
전달할 수 있으며, SDK가 이를 JSON으로 인코딩합니다. 이미 인코딩된 문자열은
변경 없이 그대로 전달됩니다.
ToolCallPart는 Pydantic 모델입니다. 생성할 때 아래 필드를 키워드 인수로 지정하세요.
필드
ToolCallResponsePart
response는 전송 시 string으로 전달됩니다. ToolCallPart.arguments와 마찬가지로 JSONString의 편의 기능을
동일하게 사용할 수 있습니다.
ToolCallResponsePart는 Pydantic 모델입니다. 인스턴스를 생성할 때 아래 필드를 키워드 인수로 지정하세요.
필드
BlobPart
BlobPart는 Pydantic 모델입니다. 인스턴스를 생성할 때 아래 필드를 키워드 인수로 지정할 수 있습니다.
필드
UriPart
UriPart는 Pydantic 모델입니다. 인스턴스를 생성할 때 아래 필드를 키워드 인수로 설정할 수 있습니다.
필드
FilePart
FilePart는 Pydantic 모델입니다. 인스턴스를 생성할 때 아래 필드를 키워드 인수로 지정할 수 있습니다.
필드
사용법
Usage는 Pydantic 모델입니다. 생성할 때 아래 필드 중 원하는 필드를 키워드 인수로 설정할 수 있습니다.
필드
추론
Reasoning은 Pydantic 모델입니다. 인스턴스를 생성할 때 아래 필드를 키워드 인수로 지정하세요.
필드
MediaAttachment
MediaAttachment는 Pydantic 모델입니다. 인스턴스를 생성할 때 아래 필드를 키워드 인수로 설정할 수 있습니다.
필드