对话
这是向智能体下达指令并获取结果的通道。响应不会一次性返回，而是以流式事件的形式陆续送达。
在会话中下达指令
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 编码。