Skip to main content

Conversations

This is the channel for issuing instructions to the agent and receiving results. Responses do not arrive all at once — they stream in as streaming events.

Issuing instructions within a session​

POST /api/session/{sessionId}/message

This instructs the agent to build or modify an app. The agent changes files and commits them.

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

Read the events in order until you reach done or error. If file_change and commit arrive along the way, files were changed at that point.

Asking questions within a session​

POST /api/session/{sessionId}/ask

This is a question, not an instruction. The agent answers without changing any files — useful for things like "Which tags is this app currently reading?"

Asking questions without a session​

POST /api/ask

This is a general query unrelated to a work session. Use it to ask about equipment data or platform status.

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

Drafting a plan​

POST /api/session/{sessionId}/plan

Instead of starting work immediately, you first receive a draft of what will be done. Use this to confirm the approach before issuing a large change. To stop, simply cancel the request.

Query history​

Session-less queries (/api/ask) are retained grouped by conversation.

MethodPathPurpose
GET/api/ask/conversationsList conversations
GET/api/ask/history?conversationId={id}Exchanges in a single conversation. Omit conversationId for the full set
PATCH/api/ask/conversations/{id}Rename a conversation (title in the body)
DELETE/api/ask/conversations/{id}Delete a conversation

{id} must be URL-encoded.