O provisionamento lê o material que já tem e transforma-o em configuração do motor. A decisão que mais influencia o resultado é o que coloca no array sources do pedido — porque o motor que recebe no fim só é tão bom quanto aquilo para onde o aponta.
Cada entrada é de um de dois tipos. Uma fonte link é um URL que a plataforma vai buscar e rastreia por si; uma fonte content é texto em bruto ou markdown que fornece diretamente. Pode misturar os dois no mesmo pedido, até um máximo de dez fontes no total. Esta página explica os dois tipos, o que a plataforma faz com cada um e como escolher fontes que produzam uma configuração útil em vez de uma configuração vazia. O próprio campo sources faz parte do pedido de criação — veja Criar um trabalho de provisionamento para ver a payload completa e a resposta 202.
Os dois tipos de fonte#
Cada fonte é um objeto com um type e um payload. O type determina como a plataforma lê o payload.
| Tipo | Payload | Use-o quando |
|---|---|---|
link | Um URL para rastrear | O contexto já está na web — a página da sua marca, documentação pública, um guia de estilo publicado, uma página de glossário. |
content | Texto em bruto ou markdown | O contexto está na sua cabeça ou num documento privado — listas de terminologia, regras de tom, convenções de nomes de produto, o que fazer e o que evitar na tradução. |
{
"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."
}
]
}Dois links e um bloco de conteúdo no mesmo array. Os links apontam para páginas que já contêm o contexto; o bloco de conteúdo transporta regras que não existem em nenhum sítio público. Ambos alimentam a mesma etapa de extração.
O que a plataforma faz com cada um#
Os dois tipos diferem numa etapa — pôr o texto à frente do agente de IA — e convergem a partir daí.
Uma fonte link é obtida e convertida para markdown antes da análise. A plataforma rastreia fontes do tipo link em paralelo, por isso dez URLs não significam dez viagens sequenciais de ida e volta — são lidos em simultâneo e depois entregues ao agente como texto. Fornece um URL; a plataforma trata da recolha e da conversão de HTML para markdown para que o agente leia prosa, não a marcação da página.
Uma fonte content salta essa etapa. O texto que envia é passado diretamente ao agente de IA, exatamente como foi escrito. Não há rastreamento, nem conversão, nem nada entre as suas palavras e o agente — por isso, uma fonte de conteúdo é a forma mais precisa de enunciar uma regra que já conhece.
A partir daí, ambos os tipos passam a ser o mesmo input: o agente lê tudo e extrai vozes da marca, itens de glossário e instruções. O que produz a partir desse texto, e o resumo que devolve, é um tema à parte — veja O que a IA extrai.
Até onde vai o rastreamento de um link?
Uma fonte link é obtida e convertida para markdown antes de o agente a analisar. Aqui não se especifica se o crawler segue links para além do URL que fornece — nem até que profundidade. Se precisar que um conjunto específico de páginas seja analisado, a abordagem mais fiável é listar cada uma como a sua própria fonte link, em vez de confiar que um único URL se expanda por si.
Escolha fontes com sinal#
É isto que determina se vale a pena correr o provisionamento. A extração só é tão boa quanto o input que recebe, e a falha aqui é silenciosa: um trabalho com fontes fracas continua a ser concluído, continua a criar um motor — mas quase vazio, e só se percebe mais tarde, quando as traduções ignoram convenções que assumia terem sido captadas. A conclusão chega como qualquer outra — veja Entrega por webhook — por isso nada lhe assinala essa lacuna.
Forneça fontes com conteúdo relevante
A qualidade da configuração extraída depende da qualidade do input. As fontes do tipo link devem apontar para páginas com contexto útil — diretrizes da marca, guias de estilo, documentação do produto, glossários. As fontes de conteúdo em bruto devem incluir terminologia concreta, orientações de tom ou regras de tradução. Páginas de marketing genéricas ou ecrãs de início de sessão produzem pouca configuração útil.
O princípio por trás deste destaque é simples: o agente extrai aquilo que é dito, não aquilo que está implícito. Uma página que diga "escrevemos num alemão amigável e direto, que usa Sie, nunca Du" produz uma voz da marca. Uma página de glossário que liste "workspace → Arbeitsbereich" produz um item de glossário. Uma landing page polida que demonstra um bom tom sem nomear uma única regra quase não produz nada, porque não há nela nenhuma regra para extrair. Em caso de dúvida, prefira a fonte que enuncia a regra de forma explícita — o que muitas vezes é um bloco content escrito por si numa frase, em vez de uma página da qual espera que o agente infira alguma coisa.
Uma fonte fraca não faz afundar o trabalho#
É natural que surja uma dúvida quando fornece várias fontes de uma só vez: se um URL estiver em baixo ou um bloco tiver pouco conteúdo, o pedido falha por completo? Não. As fontes são lidas de forma independente, e uma falha por item é registada em vez de ser fatal — um link morto ou um bloco ilegível é ignorado, e o agente trabalha com aquilo que conseguiu ler. O trabalho só falha no seu todo quando nenhuma fonte pôde ser lida, não restando nada para analisar. Os formatos exatos desses resultados — as falhas por item registadas em caso de sucesso e a payload de falha quando nada pôde ser lido — pertencem a O que a IA extrai e Entrega por webhook.
Assim, pode listar um conjunto de candidatos sem auditar primeiro todos os URLs: as fontes fortes contribuem, as fracas ficam pelo caminho, e depois lê o resumo de saída para ver o que realmente entrou. Aponte para o que já tem — e depois confirme o que voltou.
