対話

エージェントに指示を出し、結果を受け取るための経路です。応答は一度にまとめて返るのではなく、ストリーミングイベントとして流れてきます。

セッション内で指示する

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}	1つの対話のやり取り内容。conversationId を省略すると全件
PATCH	/api/ask/conversations/{id}	対話の名称変更 (本文に title)
DELETE	/api/ask/conversations/{id}	対話の削除

{id} はURLエンコードします。