대화

에이전트에게 지시하고 결과를 받는 통로입니다. 응답은 한 번에 오지 않고 스트리밍 이벤트로 흘러옵니다.

세션 안에서 지시하기

POST /api/session/{sessionId}/message

앱을 만들거나 고치라는 지시입니다. 에이전트가 파일을 바꾸고 커밋합니다.

{
  "message": "온도 그래프에 상한선 표시 추가해줘",
  "attachments": []
}

이벤트를 순서대로 읽다가 done 또는 error 에서 멈춥니다. 중간에 file_change 와 commit 이 오면 그 시점에 파일이 바뀐 것입니다.

세션 안에서 물어보기

POST /api/session/{sessionId}/ask

지시가 아니라 질문입니다. 파일을 바꾸지 않고 답만 합니다 — "이 앱이 지금 어떤 태그를 읽고 있지?" 같은 용도입니다.

세션 없이 물어보기

POST /api/ask

작업 세션과 무관한 일반 질의입니다. 설비 데이터나 플랫폼 상태를 묻는 데 씁니다.

{ "question": "어제 3라인 가동률이 어땠어?" }

계획 세우기

POST /api/session/{sessionId}/plan

바로 작업에 들어가지 않고 무엇을 할지 초안을 먼저 받습니다. 큰 변경을 지시하기 전에 방향을 확인할 때 씁니다. 중단하려면 요청을 취소하면 됩니다.

질의 이력

세션 없는 질의(/api/ask)는 대화 단위로 묶여 남습니다.

메서드	경로	하는 일
GET	/api/ask/conversations	대화 목록
GET	/api/ask/history?conversationId={id}	한 대화의 주고받은 내용. conversationId 를 빼면 전체
PATCH	/api/ask/conversations/{id}	대화 이름 바꾸기 (본문에 title)
DELETE	/api/ask/conversations/{id}	대화 삭제

{id} 는 URL 인코딩합니다.