AIチャット質問送信

指定したAI会話に新しい質問を送信します。呼び出し時に新しいチャットが作成され、AIアシスタントが応答処理を開始します。応答の進行状況は AIチャット一覧取得 APIでポーリングして確認します。

必要な権限

MEMBER以上のロールが必要です。

HTTPリクエスト

POST /api/sonar/ai/conversations/:guid/chats

cURL例

curl -H "Authorization: Bearer <API_KEY>" \
     -d question="直近1時間のブロックされたIPを教えて" \
     -d mode="auto" \
     -X POST \
     https://HOSTNAME/api/sonar/ai/conversations/a1b2c3d4-e5f6-7890-abcd-ef1234567890/chats

リクエストパラメータ

パスパラメータ

キー	型	説明	備考
guid	文字列	会話のGUID	36文字

リクエストボディパラメータ

キー	必須	型	説明	備考
question	O	文字列	ユーザーの質問
mode	X	文字列	質問の処理モード	未指定の場合は自動モード(AUTO)で動作

正常応答

{
  "guid": "c1d2e3f4-1234-5678-9abc-def012345678"
}

guid (文字列): 作成されたチャットのGUID

エラー応答

必須パラメータが欠落している場合

HTTPステータスコード 400 応答

{
  "error_code": "null-argument",
  "error_msg": "question should be not null"
}

guidがGUID形式でない場合

HTTPステータスコード 400 応答

{
  "error_code": "invalid-param-type",
  "error_msg": "guid should be guid type."
}

会話が存在しない、または所有者でない場合

HTTPステータスコード 500 応答

{
  "error_code": "illegal-state",
  "error_msg": "cannot get conversation"
}

権限がない場合

HTTPステータスコード 500 応答

{
  "error_code": "illegal-state",
  "error_msg": "no-permission"
}