Choisir un environnement d’agent

Un environnement d’agent est le programme de code qui exécute la session d’un agent dans une sandbox. Il interroge le modèle, lit et écrit des fichiers, lance des commandes et rend compte du travail. Tu le choisis pour un agent de projet ou un nœud agent d’automatisation. Le sélecteur de modèle du chat ordinaire ne choisit pas d’environnement d’agent.

Choisir l’environnement et vérifier l’accès

Dans l’onglet Agents d’un projet, ouvre un agent et choisis son Environnement d'agent. Le nœud agent d’une automatisation utilise le même nom de champ. Choisis ensuite le modèle et le fournisseur. Sous Paramètres > Fournisseurs IA, la section Environnements d'agent montre les voies d’exécution actuellement disponibles pour l’organisation.

Il faut des identifiants compatibles et de la capacité de sandbox. Un modèle qui fonctionne dans Chat ne suffit pas. Si un environnement manque ou ne propose aucun modèle, examine son état et les identifiants du fournisseur avant de modifier la demande de travail. Un modèle qui n’appelle des tools que via l’API Responses d’OpenAI, comme GPT-6 Astra ou GPT-6.1 Sol, ne fonctionne que sur Codex : le sélecteur de modèle ne le propose donc pour aucun autre environnement.

Comparer les environnements pris en charge

« Géré » signifie que le programme appelle le modèle via la passerelle de Tale. « Direct » signifie que la session reçoit les identifiants destinés aux outils du fournisseur. Les définitions livrées prennent en charge les combinaisons suivantes ; leur disponibilité dépend du déploiement et des identifiants.

Claude Code (compact prompt) est une option pour les workflows ciblés qui fournissent déjà des consignes complètes. Elle raccourcit les instructions intégrées et certaines descriptions d’outils, tout en conservant les outils, les hooks, MCP et les consignes ajoutées par Tale. Vérifie les résultats et la durée avec ton modèle avant de l’adopter : un prompt plus court ne garantit pas une exécution plus rapide. Choisis Claude Code pour retrouver le prompt complet à la prochaine nouvelle exécution. Un abonnement fournisseur réservé à Claude Code ne prend pas automatiquement en charge cette variante.

Pour guider le travail, commente la tâche et mentionne son agent. Claude Code reçoit le message entre deux appels d’outils. Pour les autres environnements, Tale arrête le processus et poursuit la même conversation dans un nouveau processus avec ton commentaire. Cela explique un redémarrage du processus après une nouvelle consigne.

Gemini CLI fait exception : Tale ne poursuit jamais une de ses conversations. Un commentaire ultérieur, une nouvelle tentative automatique ou la réponse à une question posée par l’agent démarre une nouvelle conversation dans le même espace de travail, en rappelant la consigne de la tâche et les échanges précédents, parce que l’environnement ne peut pas reprendre une conversation dans laquelle il a appelé un outil. Les fichiers et les résultats sont conservés ; seule la conversation repart de zéro.

Comprendre les identifiants et les coûts

Avec une clé API stockée ou fournie par l’environnement du déploiement, Tale remet une clé de passerelle limitée à la session. La clé d’origine du fournisseur de modèle reste dans la plateforme. Les appels de passerelle sont mesurés et soumis aux règles de dépense applicables, en tenant compte des montants déjà attribués aux autres échanges en cours.

Les abonnements fournisseurs utilisent leur environnement d’agent compatible et reçoivent les identifiants d’abonnement dans l’environnement de la session. Gemini fait exception : sa connexion Google est écrite dans un fichier du dossier personnel de la session pour l’échange, puis supprimée à la fin de l’échange. Ils ne servent pas d’identifiants de chat ordinaire et ne fonctionnent pas avec un environnement d’agent incompatible, car les fournisseurs n’autorisent les jetons d’abonnement que dans leur propre environnement ; la page Fournisseurs IA l’explique. Leurs appels directs échappent à la mesure et aux plafonds de la passerelle Tale. Examine la consommation auprès du fournisseur d’abonnement.

Ces règles sur les identifiants de modèle ne signifient pas que la sandbox ne contient aucun secret. Les Secrets explicitement accordés et le jeton d’un accès GitHub équipé peuvent y être disponibles. Limite ces accès aux besoins de la tâche.

Comprendre les fichiers et les outils connectés

Un agent de projet réutilise son espace de travail persistant entre ses tâches. Les pièces jointes sont accessibles en lecture seule sous /agent/inputs/<task>/attachments/. L’espace de travail ne garde cette copie que tant que la tâche peut encore en avoir besoin : Tale la retire dès que la tâche passe à Terminé ou Annulé, est archivée ou supprimée, ou n’a pas changé depuis 30 jours, et la prochaine exécution de la tâche y recopie les fichiers. Les fichiers écrits dans /agent/output/<task>/ sont collectés comme Fichiers produits à la fin de l’échange. Un nœud agent collecte sa sortie sous /agent/output/.

Les bundles de skills sont préparés sous forme de fichiers et cités dans les instructions de l’exécution. Examine leurs consignes et scripts avant de les accorder. Skills des agents explique cette préparation et la visibilité.

Chaque programme trouve aussi le skill intégré visual-aspect-analyzer parmi ses propres skills, sans que tu aies à l’équiper. Il pilote un vrai navigateur sur une modification d’interface terminée et signale les décalages de mise en page, le scintillement et les autres régressions visuelles. Un skill du même nom dans les dossiers .claude/skills et .agents/skills du dépôt de l’espace de travail le remplace dans chaque programme qui lit les skills d’un dépôt.

Le broker de connectors garde les identifiants ordinaires dans Tale et renvoie les résultats des actions. Il propose les lectures aux agents et refuse les écritures par cette voie. Utilise un nœud connector d’automatisation pour une écriture soumise aux règles de Tale. Les outils GitHub et les secrets explicitement accordés suivent d’autres voies : la restriction du broker n’interdit donc pas toutes les écritures depuis le shell.

Les agents qui disposent du canal MCP de Tale peuvent aussi consulter la release de Tale que signale la plateforme. En plus des outils de la plateforme accordés à l’agent, workspace_status renvoie platform.version, le numéro de release que porte le build du backend qui répond : par exemple 0.5.64 pour la release dont le tag est v0.5.64. Pour cette valeur, le backend ne lit rien dans la requête. Un build sans numéro de release, comme un build de développement, renvoie à la place null avec une courte note. Considère cette valeur comme une indication et non comme une preuve, car n’importe quel build peut porter un numéro de release. Elle ne décrit en outre que ce backend et n’indique pas si le reste du déploiement fonctionne ; la page de statut du déploiement rend compte de ses services.

L’accès sortant autorise normalement l’installation de paquets et le clonage de dépôts, tout en bloquant les adresses privées et les services de métadonnées cloud. Les opérateurs peuvent restreindre davantage les hôtes permis. Lorsqu’un service est inaccessible, examine les règles réseau avant de conclure que les identifiants sont incorrects.

Les skills de documents intégrés docx, pptx, xlsx et pdf trouvent déjà installées dans la sandbox les bibliothèques qu’ils appellent. Un agent équipé de ces skills crée et lit donc des fichiers Word, PowerPoint, Excel et PDF même là où l’installation de paquets est bloquée. Leurs consignes contiennent toujours des commandes d’installation comme npm install -g docx ; si le registre est bloqué, cette étape échoue, mais la bibliothèque préinstallée reste disponible. La reconnaissance de texte (OCR) des PDF numérisés n’est pas incluse.

Examiner le résultat

Le programme décide quand son échange est terminé ; Tale collecte le compte rendu et la sortie. Lis les deux avant de terminer la tâche. Vérifie quels contrôles ont réellement été exécutés et quels services manquaient dans la sandbox. L’automatisation des tâches explique la revue du travail de projet ; les journaux d’exécution expliquent le résultat d’un nœud agent.

Si le programme ne peut pas démarrer du tout — une configuration qu’il refuse, un répertoire d’état qu’il ne trouve pas —, l’exécution échoue aussitôt et sa cause cite les dernières lignes écrites par le programme : la cause est nommée, pas seulement un code de sortie. Une telle exécution n’est pas relancée automatiquement ; corrige la cause, puis relance-la.