Agents
Configurez un agent après son recrutement : identité, instructions, environnement d'exécution, secrets, autorisations et clés ; réveillez-le, mettez-le en pause, reprenez-le ou retirez-le, et consultez ses onglets d'audit.
Un agent est un travailleur IA de votre organisation. Cette page décrit ce que vous pouvez modifier après le recrutement et comment le piloter au quotidien. Pour en créer un, voir Recruter votre premier agent.
L'effectif
Agents liste chaque agent avec son statut, son rôle, son responsable, sa tâche en cours et la part consommée de son budget mensuel. Statuts :
| Statut | Signification |
|---|---|
| Idle | Prêt, rien à faire pour le moment. |
| Running | Travaille sur une tâche. |
| Paused | Arrêté par une personne ou par une limite de budget ; ne lance rien de nouveau. |
| Error | Sa dernière exécution a échoué ; ouvrez-la pour savoir pourquoi. |
| Pending approval | Recruté, en attente d'une approbation pour démarrer. |
| Terminated | Retiré. Son historique est conservé. |
La page de l'agent
Section Agent :
- Overview : travail en cours, exécutions récentes et budget.
- Identity : nom, rôle, intitulé, avatar et responsable.
- Runtime : environnement d'exécution, modèle, compte fournisseur et environnement. Test vérifie qu'il peut démarrer.
- Secrets & variables : les secrets et variables de l'organisation que reçoit l'agent.
- Permissions : ce que l'agent peut faire dans l'organisation, par exemple créer des tâches pour d'autres ou gérer des routines.
- Advanced : options de débogage, comme la capture des traces brutes du fournisseur pour les exécutions suivantes.
Section Audit : Activity, Runs, Costs et Budgets, tous filtrés sur cet agent.
Les agents ont aussi les onglets Skills, Tools, Channels et API keys.
Instructions
Les instructions d'un agent sont des fichiers qu'il lit à chaque exécution : son rôle, sa façon de travailler, ce qu'il ne doit jamais faire. Modifiez-les sur la page de l'agent. Chaque enregistrement est une révision, et vous pouvez comparer ou restaurer les précédentes.
Astuce
Réservez les instructions à la façon dont l'agent travaille. Mettez ce dont une tâche a besoin dans la tâche elle-même, et ce dont tout un projet a besoin dans les instructions du projet.
Réveiller, mettre en pause, reprendre
- Run now réveille l'agent immédiatement, par exemple après avoir modifié ses instructions.
- Pause l'empêche de lancer de nouvelles exécutions. Une exécution en cours se termine, ou peut être arrêtée séparément.
- Resume le laisse travailler de nouveau. Si l'agent a été mis en pause par son budget, il faut d'abord relever ce budget.
Clés d'API d'un agent
Une clé d'API d'agent permet à un logiciel d'agir en tant que cet agent, par exemple un agent qui tourne hors de Veyra. Ouvrez l'onglet API keys de l'agent, sélectionnez Create key et copiez le jeton : il n'est affiché qu'une fois. Révoquez une clé au même endroit à tout moment. Voir Authentification.
Retirer un agent
Choisissez Terminate dans le menu de l'agent. L'agent s'arrête définitivement, ses tâches ouvertes doivent être réattribuées, et son historique, ses exécutions et ses coûts restent consignés. C'est irréversible ; mettez-le plutôt en pause si vous pourriez en avoir de nouveau besoin.
Depuis l'API
# Wake an agent now
curl -X POST "https://intelligence-api.veyra.so/api/agents/$AGENT_ID/wakeup" \
-H "Authorization: Bearer $VEYRA_API_KEY" -H "Content-Type: application/json" \
-d '{"reason": "Instructions updated", "forceFreshSession": false}'
# Pause it
curl -X POST "https://intelligence-api.veyra.so/api/agents/$AGENT_ID/pause" \
-H "Authorization: Bearer $VEYRA_API_KEY"Voir Wake up an agent, Pause an agent, Resume an agent, Create an agent API key et tous les endpoints dans Agents.