프로비저닝 작업 생성

새 엔진이나 기존 엔진에 사용할 지침을 생성하고, 진행 상황 확인과 복구에 필요한 작업 식별자를 보관하세요.

프로비저닝은 API가 요청을 수락하면 시작되며 백그라운드에서 실행됩니다. 모든 경로는 https://api.lingo.dev 및 API 인증을 사용합니다.

엔진 생성 및 채우기 #

http
POST /v2/organizations/:orgId/provisioning/jobs
Content-Type: application/json
X-API-Key: YOUR_API_KEY
json
{
  "engine": { "name": "Acme support", "description": "Customer support content" },
  "kinds": {
    "glossary": { "name": "Product terminology" },
    "ruleset": { "name": "Support writing rules" },
    "brandVoice": { "name": "Support voice" }
  },
  "sources": [
    { "_tag": "Link", "url": "https://example.com/style-guide" },
    { "_tag": "Content", "text": "Use clear, direct sentences. Keep the product name Acme unchanged." }
  ]
}

예시 URL을 지침이 담긴 접근 가능한 페이지 주소로 바꾸거나, 대신 텍스트를 입력하세요.

필드명세
engine필수 엔진 생성 객체입니다. name은 비어 있으면 안 되며, description는 선택 사항입니다. 모델 구성, 적용 범위, 파이프라인 설정도 포함할 수 있습니다.
kindsglossary, ruleset, brandVoice 중 하나 이상을 선택하는 필수 객체입니다. 선택한 각 값은 {} 또는 { "name": "Nonempty name" }입니다.
sources비어 있으면 안 되는 필수 배열로, 링크 또는 텍스트 소스를 최대 10개까지 포함할 수 있습니다.

엔진 설정은 엔진 생성 명세를 따릅니다. sourceCoverage 및 targetCoverage는 로캘 배열이며, []는 모든 로캘을 포함합니다. modelConfigs를 생략하면 플랫폼의 기본 모델 설정이 초기값으로 적용됩니다. []를 사용하면 고정된 모델 구성이 없는 상태가 됩니다. 번역에 사용하기 전에 엔진의 모델을 구성하세요.

호출자에게는 엔진 생성 권한과 요청한 지침을 생성할 권한이 필요합니다. 엔진 수, 요금제 기능, 계정 크레딧, 프로비저닝 요청 빈도 제한에 따라 요청이 거부될 수 있습니다.

기존 엔진 채우기 #

http
POST /v2/engines/:engineId/provisioning/jobs
Content-Type: application/json

엔진에 연결된 세트가 없는 유형만 채우려면:

json
{
  "kinds": { "_tag": "Empty" },
  "sources": [{ "_tag": "Content", "text": "Keep Acme unchanged. Use concise, friendly language." }]
}

특정 새 세트를 요청하려면:

json
{
  "kinds": {
    "_tag": "Requested",
    "glossary": { "name": "Support terminology" },
    "ruleset": {}
  },
  "sources": [{ "_tag": "Link", "url": "https://example.com/support" }]
}

Requested는 기존 용어집이나 규칙 세트를 유지하면서 새 용어집이나 규칙 세트를 추가할 수 있습니다. 프로비저닝은 연결된 브랜드 보이스를 절대 교체하지 않습니다. Empty는 이미 세트가 연결된 유형을 건너뛰며, 작업 실행 중에 세트가 연결된 유형도 건너뜁니다. 모든 요청이 세 가지 유형을 모두 생성한다고 가정하지 말고, 유형별 결과를 검토하세요.

한 엔진에서는 한 번에 하나의 프로비저닝 작업만 실행할 수 있습니다. ProvisioningJobRunning (409)에는 기존 jobId가 포함됩니다. 추가 작업을 제출하기 전에 해당 작업의 진행 상황을 확인하세요. NothingToProvision (409)는 현재 엔진 상태에서는 요청한 작업 중 어느 것으로도 엔진을 채울 수 없다는 뜻입니다.

응답 저장 #

두 생성 경로 모두 프로비저닝 작업과 함께 HTTP 200을 반환합니다. 폴링하기 전에 id 및 engineId를 저장하세요. 초기 상태는 일반적으로 status: { "_tag": "Running" }입니다.

생성 요청에는 멱등성 헤더가 명시되어 있지 않습니다. 응답이 유실되면 새 엔진 생성 요청을 다시 보내기 전에 실행 중인 작업과 엔진 목록을 확인하세요. 요청을 다시 보내면 엔진이 하나 더 생성될 수 있습니다. 이러한 확인 절차와 실패한 유형을 재시도하는 방법은 복구에서 설명합니다.