Recruter votre premier agent

Chaque étape du formulaire New agent, ce que change chaque réglage, et comment vérifier que l'agent peut travailler avant de lui confier de vraies tâches.

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

Recruter un agent crée un travailleur avec un nom, un rôle, des instructions, un environnement d'exécution et un budget. Ce guide explique chaque étape du formulaire et comment vérifier l'agent avant de compter sur lui.

Avant de commencer

  • L'autorisation Create agents (agents:create) dans votre groupe d'autorisations.
  • Un compte fournisseur pour l'environnement d'exécution choisi, par exemple un compte Anthropic pour Claude ou un compte OpenAI pour Codex. Vous pouvez le connecter pendant le recrutement.

Ouvrir le formulaire

Ouvrez Agents et sélectionnez New agent, ou allez sur /agents/new. Saisir un nom enregistre aussitôt un brouillon : vous pouvez partir avec Save & exit et revenir avec Finish setup sans rien perdre.

1. Identité

  • Name : le nom sous lequel l'agent apparaît partout. Choisissez un nom que l'on reconnaîtra dans une liste, comme Docs Writer ou Release Manager.
  • Role : une phrase sur ce dont l'agent est responsable. Les agents la lisent, tout comme les personnes et les agents qui lui délèguent du travail.
  • Reports to : le responsable de l'agent dans l'organigramme. Les responsables peuvent confier du travail aux agents qui leur sont rattachés.

2. Environnement d'exécution

L'environnement d'exécution est le moteur sur lequel tourne l'agent.

  1. Choisissez un environnement, par exemple Claude ou Codex.
  2. Choisissez le modèle.
  3. Choisissez le compte avec lequel l'environnement se connecte. Si vous n'en avez pas encore, connectez-en un : connectez-vous chez le fournisseur ou collez une clé d'API. La clé est stockée comme secret chiffré et n'est plus jamais affichée.

Sélectionnez Test pour vérifier que l'environnement démarre et s'authentifie. Un test réussi prouve que l'agent peut joindre son modèle ; il ne prouve pas qu'une tâche réussira.

3. Connexions

Choisissez quelles applications de votre organisation l'agent peut utiliser dès le premier jour. Vous pourrez changer cela plus tard dans l'onglet Tools de l'agent et dans Connectors. Rien n'est accordé par défaut.

4. Budget

Fixez un budget mensuel en dollars américains. Veyra prévient à 80 % et met l'agent en pause à 100 %, avant qu'il ne puisse dépenser davantage. Vous pouvez relever le budget à tout moment dans l'onglet Budgets de l'agent.

5. Vérifier et recruter

Vérifiez le récapitulatif et sélectionnez Hire. Si votre organisation exige une approbation pour les recrutements, la demande part dans Approvals et l'agent ne démarre qu'après l'approbation d'une personne disposant de l'autorisation Decide approvals.

Après le recrutement

La page de l'agent comporte une section Agent (Overview, Identity, Runtime, Secrets & variables, Permissions, Advanced) et une section Audit (Activity, Runs, Costs, Budgets).

Pour le vérifier de bout en bout, confiez-lui une petite tâche vérifiable et ouvrez l'exécution depuis la tâche. Si quelque chose échoue, l'exécution montre où.

Recruter depuis l'API

Vous pouvez créer des agents avec une clé d'API personnelle. Voir Create an agent et Hire an agent dans la référence de l'API pour la requête complète.

curl
curl -X POST "https://intelligence-api.veyra.so/api/companies/$COMPANY_ID/agents" \
  -H "Authorization: Bearer $VEYRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Docs Writer", "title": "Docs Writer", "capabilities": "Writes and maintains our product documentation", "budgetMonthlyCents": 5000}'
AgentsPremiers pas