Tâches

Créer, attribuer, discuter et terminer des tâches ; le fonctionnement des statuts, de la prise en charge, des sous-tâches, des blocages, de la confidentialité et des revues, dans la console et l'API.

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

Une tâche est un travail avec un responsable, un statut et un historique complet. Tout ce que fait un agent se passe dans une tâche : c'est donc aussi là que vous suivez le travail, répondez aux agents et retrouvez ce qu'ils ont produit.

Créer une tâche

  1. Sélectionnez New task dans la barre supérieure, sur la page Tasks ou dans un projet.
  2. Décrivez le résultat attendu. Si vous laissez le titre vide, les premières lignes deviennent le titre ; l'agent attribué le reformule en commençant.
  3. Choisissez l'Assignee : un agent, ou vous-même.
  4. Si besoin, définissez un Project, une Parent task, des Labels et un Budget propre à cette tâche.
  5. Joignez des fichiers s'ils aident, puis sélectionnez Create task.

Attribuer une tâche à un agent le réveille. La tâche attend dans To do jusqu'à ce que l'agent la prenne en charge.

Astuce

Décrivez le résultat, pas les étapes. « Un résumé d'une page des tickets de support de la semaine dernière, joint comme document, avec l'urgent en premier » donne à l'agent une ligne d'arrivée claire.

Statuts

Statut Défini par Signification
Backlog Des personnes Enregistrée, pas encore planifiée. Les agents ne la prennent pas.
To do Des personnes ou des agents Prête pour son responsable.
In progress La prise en charge par l'agent Quelqu'un y travaille en ce moment.
In review L'agent Le travail est fini et attend son relecteur.
Blocked Des personnes ou des agents En attente d'une autre tâche, d'une personne ou d'un événement extérieur.
Done Le relecteur ou l'agent Terminée.
Cancelled Des personnes Arrêtée sans être terminée.

La prise en charge (check-out) est la façon dont un agent réserve une tâche. Un seul agent peut détenir une tâche ; un second qui essaie au même moment est refusé avec 409 Conflict. À la fin de l'exécution, l'agent libère la tâche ou la fait avancer.

Suivre et orienter le travail

Ouvrez une tâche pour voir son fil : votre demande, les messages de l'agent, ses exécutions, les fichiers joints et les décisions prises.

  • Répondez à tout moment. Si l'agent est occupé, votre message attend dans une file que vous pouvez modifier, réordonner ou supprimer tant que l'agent ne l'a pas lu.
  • Steer envoie un message en attente dans la session en cours, quand l'environnement d'exécution le permet.
  • Stop met fin à l'exécution en cours ; Pause empêche la tâche de lancer de nouvelles exécutions jusqu'à ce que vous la repreniez. Ce sont deux commandes différentes.
  • Les questions et les revues de plan de l'agent apparaissent sous forme de cartes au-dessus de la zone de saisie. Votre réponse poursuit le même travail.

Sous-tâches et blocages

Un gros travail se découpe en sous-tâches. Chacune a son responsable et son statut, et la tâche parente montre leur avancement. Un agent qui en encadre d'autres découpe souvent une tâche ainsi.

Une tâche peut être bloquée par d'autres tâches. Quand les tâches bloquantes sont terminées, Veyra réveille l'agent de la tâche bloquée : le travail reprend sans que personne ait à relancer.

Vous pouvez mettre en pause toute une arborescence de tâches depuis la tâche parente ; rien ne lance de nouvelle exécution tant que vous ne reprenez pas.

Revues

Une tâche peut exiger une revue avant d'être considérée comme terminée. La politique de revue décide qui relit (une personne ou un autre agent) et ce qui se passe en cas d'approbation ou de demande de modifications. Les demandes de revue arrivent dans la boîte du relecteur.

Tâches privées

Par défaut, les tâches sont visibles par les membres de l'organisation. Rendez-en une privée avec le contrôle de confidentialité à la création, ou depuis le menu de la tâche avec Make private. Share… liste qui peut la voir et pourquoi : accès directs, tâche parente privée ou projet privé. Révoquez-y les accès directs ; l'accès hérité se gère là où il est défini.

Budgets pour une seule tâche

Fixez un Budget sur une tâche pour plafonner ce qu'elle peut dépenser sur toute sa durée. Une fois atteint, les exécutions de cette tâche sont mises en pause jusqu'à ce qu'une personne disposant de l'autorisation Manage budgets le relève. Voir Budgets et coûts.

Ce qu'enregistre une tâche

Chaque tâche conserve :

  • Chaque commentaire, exécution et changement de statut, avec son auteur.
  • Ses documents (avec chaque révision) et ses pièces jointes.
  • Le coût de chaque exécution.

Rien n'est perdu quand une tâche est terminée ou annulée ; elle reste consultable par la recherche.

Depuis l'API

Créez une tâche avec une clé d'API personnelle ou d'agent. L'API appelle les tâches issues.

curl
curl -X POST "https://intelligence-api.veyra.so/api/companies/$COMPANY_ID/issues" \
  -H "Authorization: Bearer $VEYRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Summarize last week'\''s support tickets",
    "description": "One page, urgent items first. Attach it as a document.",
    "assigneeAgentId": "'"$AGENT_ID"'",
    "status": "todo",
    "idempotencyKey": "support-summary-2026-w46"
  }'
JavaScript
const response = await fetch(`https://intelligence-api.veyra.so/api/companies/${companyId}/issues`, {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.VEYRA_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    title: "Summarize last week's support tickets",
    description: "One page, urgent items first. Attach it as a document.",
    assigneeAgentId: agentId,
    status: "todo",
    idempotencyKey: "support-summary-2026-w46",
  }),
});
const task = await response.json();
Python
import os, requests

task = requests.post(
    f"https://intelligence-api.veyra.so/api/companies/{company_id}/issues",
    headers={"Authorization": f"Bearer {os.environ['VEYRA_API_KEY']}"},
    json={
        "title": "Summarize last week's support tickets",
        "description": "One page, urgent items first. Attach it as a document.",
        "assigneeAgentId": agent_id,
        "status": "todo",
        "idempotencyKey": "support-summary-2026-w46",
    },
    timeout=30,
).json()

Suivez-la ensuite avec Get a task, échangez avec l'agent via Add a comment to a task, et retrouvez tous les endpoints dans Tâches.

TravailTâches