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.

Veyra Docs TeamMis à jour le 2 min de lectureVersion 2 · Historique

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

curl
# 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.

AgentsOrganisation