Chat API

대화를 프로그래밍 방식으로 구동하세요 — 동기 또는 스트리밍, 모든 답변에 검색 출처를 포함해서.

한 턴이 처리되는 방식

모든 메시지 — 위젯, API, 또는 IM 채널에서 온 것 — 는 같은 파이프라인을 실행합니다. 인증과 멤버십/할당량 게이트가 먼저 오고, 그다음 검색이 답변에 근거를 부여하며, 그다음 도구 루프가 실행되고, 턴은 필드 암호화되어 저장되는 동안 메모리와 채널 간 전달은 백그라운드에서 일어납니다.

동기 채팅

curl https://chat.agent4.io/chat \
  -H "X-API-Key: tk_live_…" \
  -H "X-End-User: lead-1024" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "I need a bridge loan for 3 months",
    "session_id": null,
    "agent": null
  }'

요청 필드

필드	타입	비고
`message`	string	사용자의 메시지.
`session_id`	string \| null	새 세션을 시작하려면 생략하고, 이어가려면 반환된 id를 전달합니다.
`agent`	string \| null	에이전트 이름; 테넌트 기본값을 쓰려면 생략합니다.
`k`	number \| null	검색할 지식 청크 수를 재정의합니다.
`images`	string[] \| null	이번 턴용 Data-URL(base64) 이미지(멀티모달).
`audio`	string \| null	Data-URL 오디오; 서버 측에서 전사되어 메시지로 사용됩니다.

응답

{
  "session_id": "6f1e…",
  "reply": "For a 3-month bridge loan our current terms are…",
  "sources": [
    { "document_id": "a3b4…", "distance": 0.18 }
  ],
  "transcript": null
}

sources는 답변이 근거로 삼은 지식 베이스 문서를 나열합니다 — 인용을 렌더링하는 데 사용하세요. transcript는 audio를 보냈을 때 설정됩니다.

스트리밍

POST /chat/stream은 같은 본문을 받아 server-sent events를 반환하므로, 토큰이 도착하는 대로 렌더링할 수 있습니다:

curl -N https://chat.agent4.io/chat/stream \
  -H "X-API-Key: tk_live_…" \
  -H "X-End-User: lead-1024" \
  -H "Content-Type: application/json" \
  -d '{ "message": "Compare your 3 and 6 month terms" }'

언어

답변 언어는 대화를 따릅니다. 시스템 메시지와 후속 이메일을 조정하려면 Accept-Language 헤더를 보내세요. 다섯 개의 플랫폼 언어는 en, zh, zh-TW, es, ru입니다.

전체 엔드포인트 카탈로그 — 세션, 문서, 스페이스, 사용량 — 는 콘솔의 API docs 페이지에서 실시간 OpenAPI 스키마로부터 렌더링됩니다.

인증

스페이스와 지식