채팅
AI 응답 요청
API 채팅에 고객 메시지를 보내고, 그 결과로 생성된 도구 호출, 도구 결과, AI 에이전트 메시지를 순서대로 반환합니다. 메시지로 채팅이 종료되면 output에는 도구 호출과 도구 결과만 담길 수 있습니다. 메신저 채널의 채팅은 해당 채널에서 직접 고객 메시지를 받습니다.
같은 채팅에서 client_idempotency_key를 다시 보내면 AI 에이전트를 재실행하지 않습니다:
- 같은 본문, 처리 완료: 저장된 결과를 반환합니다.
- 같은 본문, 처리 중: 409 CHAT_TURN_IN_PROGRESS.
- 같은 본문, 실패: 409 CHAT_TURN_FAILED.
- 다른 본문: IDEMPOTENCY_KEY_CONFLICT로 거절합니다.
상담사가 채팅을 응대 중이거나 채널이 AI 응답을 허용하지 않으면 메시지만 저장하고 reason을 담은 202를 반환합니다.
POST
Authorizations
Body
application/json
AI 에이전트가 응답할 고객 메시지입니다.
- CreateChatMessageRequest
- CreateChatMessageRequest
Response
성공 응답
output
(ChatTurnAgentMessageResponse · object | ChatToolCallInvocationResponse · object | ChatToolCallResultResponse · object)[]
required
이번 메시지를 처리하며 나온 도구 호출, 도구 결과, AI 에이전트 메시지를 생성 순서대로 담습니다. 이 메시지로 채팅이 끝났으면 AI 에이전트 메시지가 없을 수 있습니다.
Minimum array length:
1- ChatTurnAgentMessageResponse
- ChatToolCallInvocationResponse
- ChatToolCallResultResponse