파일 첨부해 보내기

에이전트가 PDF·PNG·JPEG·텍스트 파일을 올린 뒤 새 메일과 회신에 붙여 보냅니다. 올린 파일은 악성코드 검사를 통과해야 나갑니다.

에이전트는 파일을 먼저 올리고, 받은 첨부 id를 메일에 적어 보냅니다. 올린 파일은 악성코드 검사를 통과해야 메일에 붙습니다.

보낼 수 있는 파일

파일 올릴 자리 받기
에이전트가 POST /v1/attachments에 파일 이름·종류·크기·SHA-256을 보냅니다. 응답으로 첨부 id와 올릴 주소가 옵니다.
파일 올리기
받은 주소에 파일 바이트를 그대로 올립니다. 올릴 주소는 15분 동안 한 번만 쓸 수 있습니다.
검사 기다리기
올린 파일은 곧바로 악성코드 검사를 받습니다. 보통 몇 초면 끝납니다.
메일에 붙여 보내기
새 메일(send_email)이나 회신(reply_email)에 첨부 id를 넣어 보냅니다. 검사가 아직이면 결과가 attachment_scan_pending입니다. 같은 호출을 잠시 뒤 다시 합니다.

요청과 응답의 모든 칸은 첨부 API에 있습니다.

MCP 도구 send_email과 reply_email은 attachment_ids를 받습니다. 파일 올리기는 MCP 도구가 아니라 HTTP API로 합니다. 같은 에이전트 토큰을 쓰고, 토큰에 보내기 권한이 있어야 합니다.

결과	뜻	할 일
`attachment_scan_pending`	검사가 아직 끝나지 않았습니다.	같은 요청을 잠시 뒤 다시 보냅니다.
`attachment_malicious`	악성코드가 나왔습니다.	그 파일은 보낼 수 없습니다.
`attachment_expired`	올린 지 2일이 지났습니다.	다시 올립니다.
`attachment_bytes_exceeded`	첨부 합계가 메일 한 통 한도를 넘습니다.	파일을 줄이거나 나눠 보냅니다.
`attachment_daily_limit`	에이전트의 하루 올리기 한도(24시간 100개 또는 200 MB)에 닿았습니다.	나중에 다시 올립니다.

모든 오류 코드는 첨부 API에 있습니다.

참고

첨부가 있어도 메일은 같은 발신 정책을 지납니다. 받는 사람이 막히면 첨부와 상관없이 나가지 않고, 승인이 필요한 메일은 사람이 승인할 때 첨부까지 함께 나갑니다.