이 내용을 살펴보기 전에 다음 가이드를 먼저 읽어보시면 도움이 됩니다:
다음 기능은 아래 SDK 버전부터 사용할 수 있습니다:
- Python SDK: >=0.1.141
- JS/TS SDK: >=0.2.5
Attachment 타입과 TypeScript의 Uint8Array / ArrayBuffer를 사용하여 첨부 파일을 정의하고 트레이스하는 방법을 설명합니다.
Python
Python SDK에서는Attachment 타입을 사용하여 트레이스에 파일을 추가할 수 있습니다. 각 Attachment에는 다음이 필요합니다:
mime_type(str): 파일의 MIME 타입 (예:"image/png").data(bytes | Path): 파일의 바이너리 콘텐츠 또는 파일 경로.
(mime_type, data) 형식의 튜플로 첨부 파일을 정의할 수도 있습니다.
함수를 @traceable로 데코레이트하고 Attachment 인스턴스를 인자로 포함하기만 하면 됩니다. 원시 바이트 대신 파일 경로를 사용하려면 traceable 데코레이터에서 dangerously_allow_filesystem 플래그를 True로 설정해야 합니다.
Python
TypeScript
TypeScript SDK에서는Uint8Array 또는 ArrayBuffer를 데이터 타입으로 사용하여 트레이스에 첨부 파일을 추가할 수 있습니다. 각 첨부 파일의 MIME 타입은 extractAttachments 내에서 지정됩니다:
Uint8Array: 바이너리 데이터를 직접 처리하는 데 유용합니다.ArrayBuffer: 고정 길이 바이너리 데이터를 나타내며, 필요에 따라Uint8Array로 변환할 수 있습니다.
traceable로 래핑하고 extractAttachments 옵션에 첨부 파일을 포함합니다.
TypeScript SDK에서 extractAttachments 함수는 traceable 구성의 선택적 매개변수입니다. traceable로 래핑된 함수가 호출되면, 입력에서 바이너리 데이터(예: 이미지, 오디오 파일)를 추출하고 해당 MIME 타입을 지정하여 다른 트레이스 데이터와 함께 기록합니다.
TypeScript SDK에서는 모든 런타임 환경에서 로컬 파일 접근이 지원되지 않으므로 파일 경로를 직접 전달할 수 없습니다.
TypeScript
TypeScript

Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.