AI レビュー API

POST https://api.epismo.ai/v1/reviews

curl https://api.epismo.ai/v1/reviews \
  --header "Authorization: Bearer $EPISMO_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"context":{"messages":[
    {"role":"user","content":"2 + 2 は？"},
    {"role":"assistant","content":"5 です。"}
  ]}}'

curl https://api.epismo.ai/v1/reviews \
  --header "Authorization: Bearer $EPISMO_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "instructions": "提供された記録と進捗状況から作業の健全性を healthy, at_risk, critical, unknown のいずれかで客観的に診断してください。裏付けのない判断は避け、根拠が不足している場合は unknown を選んでください。",
    "context": {
      "milestone": "v2.0 リリース",
      "records": [
        {"timestamp": "2026-10-25", "content": "主要 API の実装完了、ステージング展開済。"},
        {"timestamp": "2026-10-26", "content": "負荷テストで外部決済 Gateway のタイムアウトが 15% 発生。原因調査中。"}
      ]
    },
    "output_schema": {
      "type": "object",
      "properties": {
        "health": {
          "type": "string",
          "enum": ["healthy", "at_risk", "critical", "unknown"],
          "description": "根拠に基づく健全性の診断"
        },
        "summary": {
          "type": "string",
          "description": "現状と診断理由の要約（280文字以内）"
        },
        "risks": {
          "type": "array",
          "items": { "type": "string" },
          "description": "進行を脅かす具体的な懸念事項"
        },
        "next_actions": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "title": { "type": "string" },
              "reason": { "type": "string" }
            },
            "required": ["title", "reason"]
          },
          "description": "推奨される次の対応"
        }
      },
      "required": ["health", "summary", "risks", "next_actions"]
    }
  }'

{
	"output": {
		"health": "at_risk",
		"summary": "主要機能の実装は完了していますが、負荷テストで決済 Gateway のタイムアウトが頻発しており、期日通りのリリースにリスクがあります。",
		"risks": ["外部決済 Gateway のタイムアウトによる決済失敗"],
		"next_actions": [
			{
				"title": "決済 Gateway タイムアウトの原因調査とリトライ改善",
				"reason": "負荷時のタイムアウト原因を特定し、コネクションプールやリトライ方針を見直すため"
			}
		]
	},
	"credits_consumed": 5
}

{
	"output": {
		"content": "AI の回答に誤りがあります。2 + 2 は 5 ではなく 4 です。"
	},
	"credits_consumed": 3
}

IDEMPOTENCY_KEY=$(uuidgen)
# 同じ変数を再試行でも使い、curl に次のヘッダーを追加します:
# --header "Idempotency-Key: $IDEMPOTENCY_KEY"

{
	"error": {
		"message": "A review API key is required as a Bearer token."
	}
}