Chat messages

채팅 에이전트에게 요청을 보냅니다.

POST /v1/apps/chat-messages

Request Body

agent_id string Required
요청을 실행할 에이전트 아이디입니다.

thread_id string Optional
대화 ID를 전달해야 이전 채팅 기록을 기반으로 대화를 이어갈 수 있습니다. 이전 메시지의 thread_id를 전달해야 합니다. 처음 대화를 시작할 경우 null 값을 전달하면 새로 발급한 thread_id가 응답 메시지에 포함되어 반환됩니다.

query string Optional
사용자가 입력한 질문 내용입니다.

files array Optional
사용자가 업로드한 파일 정보{file_id, filename, size}들입니다.

context object Optional
실행 시 에이전트의 동작이나 도구 실행에 영향을 줄 수 있는 설정값들입니다. 에이전트 마다 설정할 수 있는 값들이 다릅니다. rag-agent 의 경우에는 다음과 같은 설정값들을 전달할 수 있습니다.

Click to expand

model string Required
에이전트가 사용하는 LLM의 ID입니다.

enable_thinking boolean Optional Defaults to false
추론 모드 사용 여부. 추론 모드를 사용하지 않을 경우 응답 속도가 빨라지고 응답에 사용되는 토큰 수가 줄어들 수 있습니다.

tools array Optional
에이전트가 추가적으로 사용할 수 있는 도구 목록입니다.

stream boolean or null Optional Defaults to true
True로 설정할 경우 모델 응답 데이터가 서버 전송 이벤트를 통해 생성되는 대로 클라이언트로 스트리밍되며 done 이벤트로 스트림이 종료됩니다.
자세한 내용은 Streaming events 항목을 참조하세요.

user string Optional
요청 사용자의 아이디입니다. 사용자 별 로깅이 필요할 경우 채워서 보냅니다.

Response

스트리밍 여부에 따라 AIMessage 객체(stream=false), 혹은 스트리밍된 이벤트 시퀀스(stream=true)를 전송합니다.