Um endpoint de marca branca é aquele que um revendedor adiciona à API que vende com o próprio nome. Não é uma capacidade nova — são algumas das operações que essa API já tem, em ordem, atrás de um só endereço e de um só nome que o revendedor escolheu. Os clientes dele o chamam do mesmo jeito que chamam qualquer outra coisa, e os assistentes deles o veem na lista de ferramentas ao lado das operações de que ele é feito.
Por que um revendedor quer um
Porque o produto que ele vende normalmente não é uma operação. “Aquecemos uma lista para você” é uma busca, depois uma reação a cada resultado, depois um convite para as pessoas que os escreveram — quatro chamadas que os assistentes dos clientes dele precisam acertar, e em ordem, toda vez. Um endpoint é o mesmo trabalho, nomeado uma vez só e descrito com as palavras do próprio revendedor.
Do que ele pode e não pode ser feito
Só de operações que o plano do próprio revendedor inclui. Um endpoint próprio é um atalho dentro da API que ele comprou, nunca um jeito de contorná-la: um passo que nomeia algo fora do plano é recusado quando o endpoint é escrito, não quando ele é executado.
Condições e loops são permitidos; uma linguagem de expressões não. Um valor é JSON comum ou um caminho lido do que a execução já produziu até ali, e uma condição é uma comparação. Nada é avaliado, porque o endpoint é escrito por um cliente, guardado e depois executado no servidor do provedor contra uma conta real.
O que uma chamada pode gastar
Um loop significa que um endpoint pode pedir mais trabalho do que qualquer pessoa pretendia pedir, então cada execução tem limites máximos: um número de operações, um número de iterações e um tempo limite. Atingir um deles é uma resposta, não um erro — ela diz o que já tinha sido feito, porque não há como desfazer uma mensagem que já foi enviada.
Cada passo é autorizado como uma requisição nova, então um id que o primeiro passo produziu precisa se comprovar de novo antes que o segundo possa usá-lo. Um endpoint composto não é um jeito de pular as checagens que as operações dentro dele carregam, e ele gasta o mesmo orçamento de ritmo que elas.
A outra metade: tirar o que é nosso
Um revendedor também pode ocultar operações que não quer oferecer. Ocultar tira uma operação da lista de ferramentas, do manifesto e da referência; a rota continua respondendo, então um cliente que já a chama não quebra por causa de uma mudança feita numa só frase. Um revendedor que quer uma área inteira fora deixa de oferecer essa área.
Perguntas frequentes
Um agente de IA consegue escrever um desses para mim?
É o jeito usual. Descreva o que o endpoint deve fazer e quais das suas operações ele deve usar, e o assistente escreve os passos e o salva. Se ele recorrer a uma operação que o seu plano não inclui, é recusado com o nome dela, então um palpite errado é corrigido em vez de ser guardado.
Um endpoint próprio custa mais para executar?
Custa o que custam as operações dentro dele. Uma chamada que faz quatro ações gasta o mesmo orçamento de ritmo que quatro chamadas que as fazem, porque cada passo é autorizado e recebe ritmo como uma requisição própria.