프로비저닝 결과 조회
작업과 생성된 세트, 건너뛴 작업, 부분적으로 실패한 내역을 확인하세요.
생성 시 반환된 식별자로 프로비저닝 작업을 조회하세요.
http
GET /v2/provisioning/jobs/:id
X-API-Key: YOUR_API_KEY작업 필드 #
| 필드 | 의미 |
|---|---|
id, organizationId, engineId | 작업 식별 정보와 작업이 속한 조직 및 엔진입니다. |
status | Running, Completed 또는 Failed 태그로 표시된 상태입니다. Failed에는 message이 포함됩니다. |
kinds | 요청한 glossary, ruleset, brandVoice 작업의 결과입니다. 요청하지 않은 유형은 생략될 수 있습니다. |
sources | 선택적으로 제공되는 소스 읽기 진행 상황 또는 보고서입니다. |
website | 처음 제공된 웹사이트 주소입니다. 텍스트만 입력한 경우에는 생략됩니다. |
createdAt | ISO 형식의 생성 타임스탬프입니다. |
finishedAt | ISO 형식의 완료 타임스탬프로, 처리가 확정된 후에 제공됩니다. |
유형별 상태 #
최상위 작업의 상태가 Completed인 경우에도 요청한 모든 유형을 확인하세요.
kinds.<kind>._tag | 필드 및 의미 |
|---|---|
Pending | 아직 작업 중입니다. 선택적 필드인 step의 값은 reading, generating 또는 saving이며, startedAt은 해당 단계가 시작된 시점을 나타냅니다. |
Done | setId은 연결된 세트를 식별하며, itemCount는 생성된 항목 수를 나타냅니다. |
Skipped | reason은 해당 유형이 변경되지 않은 이유를 설명합니다. |
Failed | message은 해당 유형을 채우지 못한 이유를 설명합니다. |
예를 들어 다음 결과 발췌에는 생성된 용어집과 생성에 실패한 규칙 세트가 포함되어 있습니다.
json
{
"glossary": { "_tag": "Done", "setId": "YOUR_GLOSSARY_ID", "itemCount": 12 },
"ruleset": { "_tag": "Failed", "message": "Could not generate rules from the supplied material." }
}각 유형은 개별적으로 저장됩니다. 다른 유형의 생성이 실패해도 성공적으로 생성된 지침은 계속 사용할 수 있습니다. 또한 생성이 진행되는 동안 엔진에 세트가 연결될 수 있으며, 이 경우 비어 있을 때만 채우는 작업이나 브랜드 보이스를 채우는 작업은 건너뛸 수 있습니다.
생성된 레코드 확인 #
Studio에서 엔진을 열고 연결된 용어집, 규칙 세트 또는 브랜드 보이스로 이동하세요. API로 조회하려면 다음을 사용하세요.
- 용어집 항목을 조회하려면
GET /v2/glossaries/:id/terms을 사용하세요. - 규칙을 조회하려면
GET /v2/rulesets/:id/rules을 사용하세요. - 보이스 변형을 조회하려면
GET /v2/brand-voices/:id/variations을 사용하세요.
해당하는 setId을 사용하고, 각 목록의 페이지 구분에 따라 조회하세요. 용어와 언어별 적용 여부, 번역하지 않는 이름, 모델이 추가한 가정을 확인하세요. 항목 수는 생성된 레코드 수를 나타낼 뿐, 정확성을 나타내지는 않습니다.
실패한 유형은 재시도 및 복구를 이용하세요. 대체 엔진을 만들어 모든 작업을 반복하지 말고, 완료된 세트를 보존하세요.