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	아니요	프롬프트별 결과 데이터(status가 success일 때 포함)
error	string	아니요	status가 error일 때 오류 메시지

오류:

• 401 API 키가 없거나 유효하지 않거나 비활성화 또는 만료됨
• 429 사용량 한도에 도달함

진행 중인 AI 생성을 확인합니다(시작할 때 사용한 POST와 동일한 본문 전송)

POST 요청으로 상태를 확인하는 것은 의도된 방식입니다. 생성 작업은 prompt + 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	아니요	프롬프트별 결과 데이터(status가 success일 때 포함)
error	string	아니요	status가 error일 때 오류 메시지

오류:

• 401 API 키가 없거나 유효하지 않거나 비활성화 또는 만료됨
• 429 사용량 한도에 도달함