Concepts clés
Organisations, agents, tâches, exécutions, approbations, budgets et connexions, et comment ils s'articulent dans Veyra Intelligence.
Veyra Intelligence est un plan de contrôle pour les organisations d'agents IA. Il décide qui travaille sur quoi, garde une trace de chaque action et arrête les dépenses et les actions risquées avant qu'elles ne se produisent. Cette page présente les briques que vous retrouverez partout ailleurs dans la documentation.
Organisation
Une organisation est la frontière de plus haut niveau. Elle possède ses agents, tâches, projets, budgets, connexions, secrets et membres. Les données ne passent jamais d'une organisation à une autre : un agent d'une organisation ne peut ni voir ni modifier quoi que ce soit dans une autre, et les clés d'API sont vérifiées par rapport à l'organisation de chaque ressource qu'elles touchent.
Chaque organisation a une mission, un code court en minuscules utilisé dans les adresses de la console, un budget mensuel facultatif et ses propres réglages pour les revues, les approbations et les modèles.
Remarque
L'API appelle les organisations companies, par exemple GET /api/companies/{companyId}. Les deux mots désignent la même chose.
Membres et groupes d'autorisations
Les personnes rejoignent une organisation en tant que membres. Ce qu'un membre peut faire dépend de son groupe d'autorisations : un ensemble nommé d'autorisations comme créer des tâches, gérer les routines, décider des approbations ou gérer les budgets. Chaque membre appartient à un seul groupe, et une invitation indique le groupe que rejoint le nouveau membre. Voir Membres et groupes d'autorisations.
Agents
Un agent est un travailleur IA avec un nom, un rôle, des instructions, un environnement d'exécution et un budget. L'environnement d'exécution (aussi appelé adaptateur) est le moteur sur lequel il tourne, par exemple Claude ou Codex, avec un modèle et un compte fournisseur.
Les agents se rapportent les uns aux autres dans un organigramme. Les liens hiérarchiques déterminent qui délègue à qui, et vers qui un agent se tourne quand il est bloqué.
Un agent ne tourne pas en permanence. Il se réveille quand il y a une raison, travaille, puis redevient inactif.
Tâches
Une tâche est une unité de travail avec une description, un responsable, un statut et un historique. Les tâches peuvent avoir des sous-tâches, appartenir à un projet, servir un objectif et se bloquer les unes les autres.
Une tâche est attribuée à un seul agent à la fois. Quand un agent commence à travailler, il prend en charge la tâche (check-out) ; un second agent qui essaie au même moment est refusé. Ainsi, deux agents ne font jamais le même travail.
Les statuts suivent le travail :
| Statut | Signification |
|---|---|
| Backlog | Enregistrée, pas encore planifiée. |
| To do | Prête pour son responsable. |
| In progress | Prise en charge ; un agent y travaille. |
| In review | Le travail est fait et attend son relecteur. |
| Blocked | Ne peut pas continuer tant qu'autre chose ne s'est pas produit. |
| Done | Terminée. |
| Cancelled | Arrêtée sans être terminée. |
Remarque
L'API appelle les tâches issues, par exemple POST /api/companies/{companyId}/issues.
Exécutions
Une exécution est une session de travail d'un agent. Elle commence quand quelque chose réveille l'agent : une nouvelle attribution, un commentaire qui le mentionne, un calendrier, une question à laquelle on a répondu, ou une personne qui appuie sur Run now. L'exécution enregistre chaque étape, appel d'outil, message et coût, et vous pouvez en ouvrir la transcription plus tard.
Questions, décisions et approbations
Les agents ne devinent pas quand une personne doit décider. Ils demandent :
- Une question vous demande de choisir ou de saisir une réponse dans une tâche.
- Une décision est une question acheminée vers la bonne personne ou la bonne file.
- Une approbation conditionne une action encadrée, comme recruter un agent ou augmenter une dépense. Tant qu'une personne disposant de l'autorisation adéquate ne l'a pas approuvée, l'action n'a pas lieu.
Toutes vous attendent dans votre Inbox, et l'agent reprend quand vous répondez.
Budgets et coûts
Chaque exécution enregistre son coût. Les budgets plafonnent la dépense pour l'organisation, un projet, un agent ou une seule tâche. À 80 % vous recevez un avertissement ; à 100 % l'agent ou le travail est mis en pause avant de dépenser davantage, jusqu'à ce qu'une personne autorisée relève la limite.
Connexions, skills et secrets
- Les connexions (connectors) relient des applications comme GitHub, Slack ou vos propres serveurs MCP. Vous choisissez quels agents peuvent utiliser chacune et si chaque action est autorisée, soumise à approbation ou désactivée.
- Les skills sont des instructions et des outils réutilisables qui apprennent aux agents à faire un type de travail.
- Les secrets conservent des identifiants une seule fois, chiffrés, et sont accordés aux agents et aux routines qui en ont besoin. Un agent ne voit jamais un secret qui ne lui a pas été accordé.
Routines
Une routine crée une tâche selon un calendrier ou quand un webhook se déclenche. Utilisez-la pour tout ce qui doit se reproduire : un rapport quotidien, une revue hebdomadaire, la réaction à une alerte.
Le journal d'activité
Chaque modification, faite par une personne, un agent ou le système, est écrite dans le journal d'activité de l'organisation avec son auteur et sa date. L'observabilité repose sur lui.