APIリファレンス：AI

AIエンドポイントでは、AIプロンプトを非同期で実行し、ポーリングして結果を取得できます。

AIへの直接プロンプトの開始（非同期。開始時と同じ本文でPOST …/ai/{promptType}/statusをポーリング）

エンドポイント： POST /v1/tenant/{tenantId}/ai/{promptType}

**認証：**テナント単位のAPIキー · writeスコープ

パラメーター：

名前	型	場所	必須	説明
tenantId	string	path	はい	形式：uuid
promptType	processAnalysis | processQuestion | aiSummary | processDocumentation | processRaci | processMetaEdit	path	はい	使用できる値：processAnalysis、processQuestion、aiSummary、processDocumentation、processRaci、processMetaEdit

リクエスト本文：

{
	"prompt": "string",
	"summaryVariant": "string"
}

フィールド	型	必須	説明
prompt	string	はい	自然言語によるプロンプト 最大長：10000
summaryVariant	string	いいえ

レスポンス（200）：

AIの結果（ステータス：success | generating | error）

{
	"status": "success",
	"result": {
		"type": "processAnalysis",
		"analysis": "string"
	},
	"error": "string"
}

フィールド	型	必須	説明
status	success | error | generating	はい	使用できる値：success、error、generating
result	object | object | object | object | object | object	いいえ	プロンプトごとの結果データ（ステータスがsuccessの場合に提示）
error	string	いいえ	ステータスがerrorの場合のエラーメッセージ

エラー：

• 401 APIキーがない、無効、無効化済み、または期限切れ
• 429 利用上限に到達

実行中のAI処理をポーリング（開始時のPOSTとまったく同じ本文を送信）

POSTを使ってポーリングするのは意図的な仕様です。処理はプロンプト、promptType、summaryVariantの組み合わせで識別されるため、実行IDではなく、同じ本文を再送して状態を確認します。

エンドポイント： POST /v1/tenant/{tenantId}/ai/{promptType}/status

**認証：**テナント単位のAPIキー · writeスコープ

パラメーター：

名前	型	場所	必須	説明
tenantId	string	path	はい	形式：uuid
promptType	processAnalysis | processQuestion | aiSummary | processDocumentation | processRaci | processMetaEdit	path	はい	使用できる値：processAnalysis、processQuestion、aiSummary、processDocumentation、processRaci、processMetaEdit

リクエスト本文：

{
	"prompt": "string",
	"summaryVariant": "string"
}

フィールド	型	必須	説明
prompt	string	はい	自然言語によるプロンプト 最大長：10000
summaryVariant	string	いいえ

レスポンス（200）：

AIの結果（ステータス：success | generating | error）

{
	"status": "success",
	"result": {
		"type": "processAnalysis",
		"analysis": "string"
	},
	"error": "string"
}

フィールド	型	必須	説明
status	success | error | generating	はい	使用できる値：success、error、generating
result	object | object | object | object | object | object	いいえ	プロンプトごとの結果データ（ステータスがsuccessの場合に提示）
error	string	いいえ	ステータスがerrorの場合のエラーメッセージ

エラー：

• 401 APIキーがない、無効、無効化済み、または期限切れ
• 429 利用上限に到達