Un endpoint en marque blanche est un endpoint qu'un revendeur ajoute à l'API qu'il vend sous son propre nom. Ce n'est pas une nouvelle capacité — ce sont quelques-unes des opérations que cette API possède déjà, dans l'ordre, derrière une seule adresse et un seul nom que le revendeur a choisis. Ses clients l'appellent comme ils appellent n'importe quoi d'autre, et leurs assistants le voient dans la liste d'outils, à côté des opérations dont il est fait.
Pourquoi un revendeur en veut un
Parce que le produit qu'il vend n'est généralement pas une opération. « Nous réchauffons une liste pour vous » est une recherche, puis une réaction pour chaque résultat, puis une invitation aux personnes qui les ont écrits — quatre appels que les assistants de ses clients doivent réussir, dans l'ordre, à chaque fois. Un endpoint est le même travail, nommé une seule fois et décrit avec les mots propres du revendeur.
Avec quoi il peut, et ne peut pas, être construit
Uniquement avec des opérations que comprend le propre plan du revendeur. Un endpoint à lui est un raccourci à travers l'API qu'il a achetée, jamais un moyen de la contourner : une étape qui nomme quelque chose hors de son plan est refusée quand l'endpoint est écrit, pas quand il s'exécute.
Les conditions et les boucles sont permises ; un langage d'expressions ne l'est pas. Une valeur est du JSON ordinaire ou un chemin lu dans ce que l'exécution a produit jusque-là, et une condition est une comparaison. Rien n'est évalué, parce que l'endpoint est écrit par un client, stocké, puis exécuté sur le serveur du fournisseur contre un vrai compte.
Ce qu'un appel peut dépenser
Une boucle signifie qu'un endpoint peut demander plus de travail que personne n'avait voulu en demander, si bien qu'une exécution a des plafonds : un nombre d'opérations, un nombre d'itérations et une durée. En atteindre un est une réponse, pas une erreur — elle dit ce qui avait déjà été fait, parce qu'on ne peut pas reprendre un message déjà envoyé.
Chaque étape est autorisée comme une requête neuve, si bien qu'un identifiant produit par la première étape doit se justifier à nouveau avant que la seconde puisse l'utiliser. Un endpoint composé n'est pas un moyen d'éviter les contrôles que portent les opérations qu'il contient, et il dépense le même budget de cadence qu'elles.
L'autre moitié : retirer les nôtres
Un revendeur peut aussi masquer des opérations qu'il ne veut pas proposer. Masquer une opération la retire de la liste d'outils, du manifeste et de la référence ; la route répond toujours, de sorte qu'un client qui l'appelle déjà n'est pas cassé par un changement fait en une phrase. Un revendeur qui veut qu'un domaine entier disparaisse cesse de proposer ce domaine.
Questions fréquentes
Un agent IA peut-il en écrire un pour moi ?
C'est la façon habituelle. Décrivez ce que l'endpoint doit faire et lesquelles de vos opérations il doit utiliser, et l'assistant écrit les étapes et l'enregistre. Il est refusé, avec le nom de l'opération, s'il en réclame une que votre plan ne comprend pas, si bien qu'une supposition erronée est corrigée au lieu d'être enregistrée.
Un endpoint qui m'est propre coûte-t-il plus cher à exécuter ?
Il coûte ce que coûtent les opérations qu'il contient. Un appel qui effectue quatre actions dépense le même budget de cadence que quatre appels qui les effectuent, parce que chaque étape est autorisée et cadencée comme une requête à part.