채팅
채팅 메시지 전송
API 채팅에 사용자 메시지를 보냅니다. 에이전트가 응답하면 저장된 결과를 순서대로 반환합니다. 위젯·SMS·카카오의 사용자 입력은 각 채널에서 받습니다. 같은 채팅에 같은 client_idempotency_key를 다시 보내면 에이전트를 재실행하지 않고 저장된 결과를 반환합니다.
POST
Authorizations
워크스페이스 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.
Path Parameters
채팅 ID입니다.
Body
application/json
사용자 메시지와 중복 전송 방지 키입니다. 에이전트 응답을 기다린 뒤 결과를 반환합니다.
- CreateChatMessageRequest
- CreateChatMessageRequest
사용자 메시지 텍스트입니다.
Minimum string length:
1채팅 안에서 사용자 메시지를 식별하는 멱등 키입니다. 같은 키를 다시 보내면 에이전트 턴을 재실행하지 않고 저장된 결과를 반환합니다.
Required string length:
1 - 128images
(ChatMessageFileKeyImageInput · object | ChatMessageBase64ImageInput · object | ChatMessageUrlImageInput · object)[] | null
선택 이미지 입력입니다. 최대 3장까지 지원합니다.
Required array length:
1 - 3 elements- ChatMessageFileKeyImageInput
- ChatMessageBase64ImageInput
- ChatMessageUrlImageInput
Response
성공 응답
채팅 ID입니다.
이번 턴이 완료된 상태입니다. ended는 이 턴이 채팅을 종료했음을 뜻합니다.
Available options:
active, ended 처리한 사용자 메시지 ID입니다.
output
(ChatTurnAgentMessageResponse · object | ChatToolCallInvocationResponse · object | ChatToolCallResultResponse · object)[]
required
이번 턴에서 생성된 도구 호출, 도구 결과, 에이전트 메시지입니다.
Minimum array length:
1- ChatTurnAgentMessageResponse
- ChatToolCallInvocationResponse
- ChatToolCallResultResponse