Vytvoření provisioning jobu

Pošlete zdroje, které už máte, a zpátky dostanete engine. POST /jobs/provisioning přijímá název nového engine a až 10 zdrojů – odkazy ke crawlování nebo surový text – a vrací 202 Accepted s ID engine. Nemusíte čekat, až AI dočte váš obsah: engine existuje ve chvíli, kdy se volání vrátí, a jeho konfigurace se průběžně aplikuje během běhu úlohy.

POST /jobs/provisioning

Tato stránka popisuje create call: jeho parametry, podobu requestu a odpověď 202. S asynchronním provisioningem začínáte? Začněte na stránce Přehled Async Provisioning API, kde najdete základní mentální model. Co se počítá jako kvalitní zdroj, řeší samostatná stránka – Typy zdrojů – a co z nich AI vytahuje, najdete na stránce Co AI extrahuje.

Parametry#

Povinné je jen engine.name. Všechno ostatní určuje, co se engine naučí – nebo, pokud nic dalšího neuvedete, vám zůstane čistý engine s výchozím nastavením.

Request#

Zdroj je objekt { type, payload }. Zdroje link směrujte na stránky se skutečným kontextem – pravidla značky, stylistické příručky, produktovou dokumentaci – a content použijte pro terminologii a pravidla tónu, která můžete vložit přímo. Níže uvedený request kombinuje obojí: dvě stránky ke crawlování a jeden blok explicitních pravidel.

const response = await fetch("https://api.lingo.dev/jobs/provisioning", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.LINGO_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    engine: {
      name: "Acme Corp Engine",
      description: "Production localization engine for acme.com",
    },
    locales: ["de", "fr", "ja", "es"],
    sources: [
      { type: "link", payload: "https://acme.com/brand-guidelines" },
      { type: "link", payload: "https://acme.com/docs/style-guide" },
      {
        type: "content",
        payload:
          "Brand name 'Acme' is never translated. Use formal tone in German (Sie-form). Product names: AcmeFlow, AcmeSync, AcmeVault - always keep in English.",
      },
    ],
    callbackUrl: "https://your-app.com/webhooks/provisioning",
  }),
});

const { jobId, engineId, status } = await response.json();
// 202 back right away.
// status: "in_progress" – the AI is reading your sources.
console.log(engineId); // "eng_X1y2Z3a4B5c6D7e8" – usable right now

Odpověď (202 Accepted)#

Volání se vrátí bez čekání na crawl nebo analýzu – dostanete ID úlohy pro sledování a ID engine, které je od této chvíle aktivní.

{
  "jobId": "pjb_A1b2C3d4E5f6G7h8",
  "engineId": "eng_X1y2Z3a4B5c6D7e8",
  "status": "in_progress"
}

Právě tenhle detail dělá z tohoto async volání lepší volbu než čekání: engineId se vrací už v té samé odpovědi 202 a hned ukazuje na skutečný engine. Můžete si ho uložit, poslat přes něj synchronní request Localize nebo ho zapojit do své aplikace ještě předtím, než AI přečte jediný zdroj. Jakmile se extrahují hlasy značky, položky glosáře a instrukce, platforma každou z nich aplikuje na tentýž engine – engine existuje dřív než jeho konfigurace. Pokud chcete přesně vědět, co úloha vytvořila, přečtěte si Co AI extrahuje.

Další kroky#