Fournisseurs IA

Connecte un fournisseur IA avant de lancer des chats ou des agents dans Tale. Dans Paramètres > Fournisseurs IA, les propriétaires, admins et développeurs gèrent les identifiants de l’organisation. Le fournisseur définit la connexion et les méthodes d’authentification ; les identifiants donnent à ton organisation accès à ce fournisseur.

Ajouter les premiers identifiants

1. Sélectionne Ajouter des identifiants, puis le fournisseur. Les fournisseurs déjà configurés apparaissent en premier ; les choisir à nouveau permet d’ajouter d’autres identifiants.
2. Choisis une Méthode d'authentification si le fournisseur en propose plusieurs.
3. Vérifie le champ Nom. Il est prérempli avec le nom du fournisseur, suivi d’un numéro si d’autres identifiants de ce fournisseur portent déjà ce nom : OpenRouter, puis OpenRouter 2. Un nom qui indique l’usage, comme Clé de production ou Équipe finance, permet de distinguer plusieurs identifiants d’un même fournisseur. Renseigne ensuite les champs requis par la méthode.
4. Vérifie la liste Modèles autorisés. Pour un fournisseur avec catalogue, une liste vide autorise les modèles du catalogue. Sans catalogue, tu dois préciser les identifiants des modèles.
5. Sélectionne Ajouter. Vérifie la ligne créée et définis-la par défaut pour ce fournisseur si les requêtes habituelles doivent l’utiliser.

Pour des identifiants de type Clé API ou Variable d'environnement, envoie un court message de test dans un chat avec le modèle prévu. Le modèle doit être disponible via des identifiants actifs et autorisé par les règles de l’organisation. Vérifie les identifiants d’abonnement avec un agent de tâche ou d’automatisation, comme indiqué ci-dessous. Enregistrer des identifiants ne prouve pas que le fournisseur acceptera les requêtes.

Choisir la méthode d’authentification

Seules les méthodes du fournisseur sélectionné apparaissent. Référencer une variable ne la crée pas : demande à l’opérateur de la fournir selon le guide de configuration des fournisseurs.

Utiliser les abonnements dans les tâches, pas dans le chat

Des identifiants de type Clé d'abonnement ou Courtier d'abonnement ne fonctionnent que dans l’environnement d’agent auquel ils sont liés : Claude Code pour un abonnement Anthropic et pour les forfaits de programmation de Moonshot et de Z.ai, Codex pour un abonnement ChatGPT, Gemini CLI pour Gemini et Hermes pour Nous Portal. Les fournisseurs n’autorisent pas les jetons d’abonnement dans d’autres applications, et Anthropic les refuse depuis tout client autre que Claude Code. Le chat appelle l’API du fournisseur depuis Tale même : il ne peut donc pas utiliser d’identifiants d’abonnement.

Tale exécute donc un abonnement dans les tâches et les automatisations, où son environnement travaille dans une sandbox. Le chat ne propose que les modèles servis par des identifiants de type Clé API ou Variable d'environnement. L’application l’indique à trois endroits : le formulaire d’ajout affiche Tâches et automatisations uniquement quand tu choisis une méthode d’abonnement, chaque ligne d’abonnement du tableau des identifiants porte la même mention, et la liste des modèles du chat nomme les abonnements qu’elle laisse de côté.

Pour discuter avec un modèle auquel tu accèdes par un abonnement, ajoute des identifiants par clé API ou variable d’environnement pour le même fournisseur, ou connecte un fournisseur comme OpenRouter qui sert ce modèle.

Coller un jeton OAuth Claude

Pour utiliser un abonnement Anthropic sans courtier, choisis Clé d'abonnement et colle un jeton OAuth Claude, par exemple un jeton obtenu avec claude setup-token. Tale transmet ce jeton à Claude Code sous le nom CLAUDE_CODE_OAUTH_TOKEN, dans les tâches et les automatisations.

Tale ne renouvelle pas un jeton collé. Quand il expire, ou quand tu passes à un autre compte Claude, utilise l’action de remplacement de la ligne pour en coller un nouveau, puis relance la tâche. Renouveler ou retirer des identifiants décrit cette action.

Coller un jeton d’abonnement OpenAI ChatGPT

Choisis Clé d'abonnement, colle le jeton d’accès et saisis l’ID du compte ChatGPT indiqué par la revendication chatgpt_account_id. Codex utilise ces deux valeurs. Limite les modèles à ceux pris en charge par ton abonnement ; ces identifiants servent uniquement aux tâches et aux automatisations.

Connecter un courtier d’abonnement

Les courtiers d’abonnement prennent en charge les abonnements Anthropic via Claude Code et les abonnements OpenAI ChatGPT via Codex. Ces identifiants servent aux agents de tâche et d’automatisation ; les chats nécessitent des identifiants d’accès direct à l’API, pour les raisons expliquées plus haut.

À l’ajout des identifiants, choisis Courtier d'abonnement et demande à ton opérateur l’adresse du courtier et les paramètres d’authentification. Utilise une adresse qui ne fournit que les jetons du fournisseur choisi. Avec Tale AI Gateway, il s’agit de /api/tokens/anthropic ou de /api/tokens/openai.

Renseigne $.tokens dans Chemin du tableau de jetons, access_token dans Champ du jeton et la valeur du tableau ci-dessus dans Variable d'environnement cible. Sous Avancé, utilise status pour Champ de statut, active pour Valeur de statut actif et expires_at pour Champ d'expiration, et laisse Marge de sécurité avant expiration (ms) à sa valeur par défaut. Tale AI Gateway retient lui-même un compte dont le jeton va bientôt être actualisé tant qu’un autre compte peut prendre le travail ; Tale l’utilise quand même si aucun autre compte disponible ne peut prendre l’exécution, par exemple pendant que les autres sont en pause après avoir atteint une limite de requêtes. Les chemins peuvent différer avec un autre courtier. Un pool OpenAI doit aussi fournir l’account_id du fournisseur pour chaque jeton utilisable ; l’id propre au courtier est un identifiant de compte distinct.

Pour OpenAI, limite Modèles autorisés aux identifiants de modèles pris en charge par ton abonnement ChatGPT. Le catalogue de l’API OpenAI peut inclure des modèles auxquels cet abonnement ne donne pas accès.

Pour utiliser un modèle GPT-6 avec l’abonnement ChatGPT, enregistre les identifiants du courtier OpenAI, puis configure un agent de projet en choisissant Codex sous Environnement d'agent. Sous Modèle, recherche l’identifiant du modèle, par exemple gpt-6.1-sol, et sélectionne l’entrée OpenAI · Abonnement. Utiliser les modèles GPT-6 indique où chaque modèle fonctionne par ailleurs.

Choisis Sélection du jeton selon la répartition souhaitée pour les nouveaux tours d’agent :

• Aléatoire, le choix initial, donne à chaque compte utilisable la même probabilité à chaque sélection.
• Premier utilisable prend toujours le premier compte utilisable dans l’ordre du courtier. Ce choix établit un ordre de préférence, sans répartir le travail.
• Round-robin choisit le compte utilisable dont la dernière sélection est la plus ancienne. Tous les processus backend partagent cet historique pour l’organisation et les identifiants concernés, y compris lors de requêtes simultanées. L’ordre des réponses et les redémarrages du backend conservent cet historique ; des identifiants de compte stables chez le courtier le préservent aussi lors des changements de jetons. Cela répartit les sélections, sans garantir une consommation de jetons ou un nombre d’agents en cours identiques.

Enregistre les identifiants, puis lance une courte tâche ou automatisation avec le fournisseur et l’environnement d’agent correspondants. Vérifie que l’agent termine sa réponse. Si aucun compte n’est utilisable, demande à l’opérateur de vérifier l’autorisation des comptes, l’expiration et les actualisations prévues des jetons, ainsi que les quotas signalés. La référence de configuration du courtier décrit les métadonnées facultatives, les valeurs par défaut et les solutions aux erreurs.

Utiliser les modèles GPT-6

Le catalogue OpenAI comprend GPT-6 Astra (gpt-6-astra), GPT-6 Sol (gpt-6-sol), GPT-6 Luna (gpt-6-luna) et GPT-6.1 Sol (gpt-6.1-sol).

• Le chat propose les quatre via des identifiants OpenAI de type Clé API ou Variable d'environnement, y compris pour la sélection automatique du modèle. Astra et GPT-6.1 Sol n’appellent des tools que via l’API Responses d’OpenAI : Tale les interroge donc par cette API. GPT-6 Sol et Luna n’acceptent les tools du chat qu’avec le raisonnement désactivé : le sélecteur ne propose donc pas de niveau d’Effort de raisonnement pour eux.
• Les agents de projet et les automatisations n’exécutent Astra et GPT-6.1 Sol que sur Codex, l’environnement qui parle l’API Responses, avec des identifiants par clé API, variable d’environnement ou abonnement ChatGPT. Le sélecteur de modèle ne les propose pour aucun autre environnement.

Configurer Azure ou une adresse propre au compte

Azure OpenAI demande une URL de l'endpoint, généralement https://<resource>.openai.azure.com/openai/v1. Les identifiants appartiennent à cette ressource. Les identifiants de modèle Azure sont les noms de déploiement définis dans la ressource : saisis-les dans la liste Modèles autorisés. Sans catalogue, laisser cette liste vide ne rend aucun modèle disponible.

Utilise les adresses et identifiants documentés par le fournisseur. Le nom affiché sur une page commerciale n’est pas forcément celui que son API accepte.

Définir un fournisseur personnalisé

Une organisation peut connecter un endpoint absent du catalogue livré : un serveur de modèles auto-hébergé comme vLLM ou Ollama, ou une passerelle interne qui parle l’API OpenAI ou Anthropic. Choisis Ajouter des identifiants, puis Fournisseur personnalisé, l’entrée fixée sous le catalogue :

1. Saisis un Nom du fournisseur. Il nomme le fournisseur et cet identifiant ; le nom technique du fournisseur en est dérivé.
2. Choisis le Format d'API que parle l’endpoint et saisis son URL de base, la racine d’API à laquelle la plateforme ajoute ses chemins. Un hôte public exige https.
3. Sous Modèles, garde Découvrir depuis l'endpoint pour lire la liste /models du serveur avec cette clé, ou choisis Saisir les ID de modèles et indique les ID exacts dans Modèles autorisés si l’endpoint ne sait pas lister ses modèles.
4. Renseigne la Clé API (ou la variable d’environnement), puis choisis Ajouter.

La ligne de l’identifiant affiche désormais le fournisseur avec le badge Personnalisé, et le fournisseur apparaît avec le même badge dans le catalogue d’Ajouter des identifiants ; le choisir là ajoute un autre identifiant pour lui. Une adresse privée ou de boucle locale exige en plus l’autorisation des hôtes privés dans le déploiement ; c’est l’opérateur qui la définit, et enregistrer l’identifiant ne l’accorde pas. Demande à l’opérateur de préparer l’accès réseau et la politique du déploiement, puis suis Connecter un serveur de modèles local. Si des agents de programmation utiliseront le fournisseur, teste aussi une session d’agent : leur trafic passe par une passerelle distincte qui doit aussi disposer de l’accès réseau et faire confiance au certificat.

Dans le menu de la ligne, Vérifier les modèles relit la liste de modèles de l’endpoint avec cette clé, Modifier les identifiants change, à côté du nom, l’URL de base, le format d’API et la source des modèles, et Supprimer retire l’identifiant. Lors de la modification, Enregistrer change le fournisseur et l’identifiant ensemble : un nom déjà utilisé ou une version périmée est refusé avant toute modification. Si quelqu’un a enregistré le fournisseur ou cet identifiant après que tu as ouvert la boîte de dialogue, ton enregistrement est refusé au lieu d’écraser sa modification ; rouvre la boîte de dialogue pour charger les réglages actuels. Supprimer le dernier identifiant d’un fournisseur retire aussi le fournisseur lui-même ; la boîte de dialogue le dit avant. Chaque version enregistrée de la définition reste dans l’historique de configuration de l’organisation. Ce que le formulaire ne couvre pas, comme un endpoint pour les agents de programmation, se règle dans le fichier de définition que décrit le guide de configuration des fournisseurs.

Si la connexion est interrompue pendant l’enregistrement, le résultat peut être incertain. Recharge la page et vérifie les réglages du fournisseur et l’identifiant avant de réessayer : une erreur de connexion ne signifie pas que les modifications ont été annulées.

Définir le choix par défaut et l’accès aux modèles

Sélectionne Définir par défaut dans le menu d’une ligne. Chaque fournisseur a un seul choix par défaut ; en sélectionner un autre déplace le badge. Des identifiants désactivés ne peuvent pas devenir le choix par défaut. En son absence, l’appelant doit nommer les identifiants à utiliser.

La liste Modèles autorisés limite seulement les identifiants concernés. Modèles définit les modèles par défaut et les règles d’accès des personnes, équipes et rôles pour tous les fournisseurs. Les deux restrictions s’appliquent : élargir une liste ne contourne pas l’autre.

La section Environnements d'agent, sous le tableau, est en lecture seule. Elle présente les modèles et abonnements disponibles pour chaque environnement d’agent. Modifie les identifiants au-dessus pour changer cette configuration. Un environnement d’agent est signalé En échec récemment quand au moins la moitié de ses exécutions des 30 dernières minutes ont échoué, à partir de trois exécutions. Si Tale ne peut pas le vérifier, un avis au-dessus de la liste l’indique, avec Réessayer.

Résoudre un modèle absent ou en échec

• S’il manque un choix par défaut, sélectionne les identifiants actifs prévus et définis-les par défaut.
• Si le catalogue n’a pas pu être chargé, utilise Actualiser les catalogues et examine le résultat du fournisseur. Les catalogues distants sont mis en cache ; les catalogues intégrés évoluent avec la plateforme.
• Si un modèle manque, vérifie la liste des modèles autorisés et les règles de l’organisation. Sans catalogue, vérifie les identifiants exacts des modèles.
• Si une requête est refusée, vérifie l’activation des identifiants, les droits du compte fournisseur, l’adresse et le quota fournisseur avant de modifier les règles des modèles.

Renouveler ou retirer des identifiants

Utilise l’action de remplacement de la ligne pour changer le secret en conservant le nom et les références. Désactiver suspend les identifiants sans retirer leur configuration ; Activer les remet en service. Vérifie le remplacement avec le modèle prévu.