Exemples d'utilisation

Des demandes réelles d'utilisateurs d'Oxygenius, les outils que l'assistant enchaîne et ce que l'utilisateur obtient. Les identifiants et montants des exemples sont fictifs.

Bonnes pratiques
  • Nommez le dossier, le client ou la personne : l'assistant commence presque toujours par une recherche (search_*).
  • Pour une écriture, l'assistant annonce précisément ce qu'il va faire et attend votre accord : relisez-le.
  • Les envois hors de la société passent toujours par un aperçu (prepare_*) : vérifiez les destinataires et le contenu avant d'accepter.

Consulter

1. Faire le point sur un chantier

Lecture

Demande

« Où en est le chantier de M. Dupont à Namur ? Donne-moi l'étape en cours, le gestionnaire et ce qui reste à facturer. »

Ce que fait l'assistant

  1. search_dossiers avec query: "Dupont Namur" : la recherche porte sur le client, l'adresse du chantier et les références.
  2. get_dossier sur le dossier trouvé : statut, gestionnaire, étape en cours, intervenants.
  3. search_estimates avec dossierId, puis get_estimate sur le devis accepté : montant signé et reste à facturer.

Résultat. Un résumé du dossier : étape, gestionnaire, adresse, devis accepté, montants déjà facturés et reste à facturer. Si plusieurs dossiers correspondent, l'assistant demande lequel.

2. Lister les factures en retard

Lecture

Demande

« Quelles factures sont en retard de paiement ? Classe-les par montant restant dû. »

Ce que fait l'assistant

  1. search_invoices avec state: "overdue" : solde restant dû et retard recalculés (montant à payer − notes de crédit − paiements).
  2. Si le résultat indique hasMore: true, l'assistant rappelle l'outil avec offset pour la page suivante.

Exemple d'arguments

{
  "state": "overdue",
  "limit": 25
}

Résultat. Un tableau des factures échues et non soldées : client, numéro, échéance, jours de retard, solde ; le total dû.

3. Préparer la semaine

Lecture

Demande

« Qui travaille sur quels chantiers la semaine prochaine ? »

Ce que fait l'assistant

  1. search_planning_events sur la période : une occurrence par jour avec les personnes affectées, en heure locale belge.
  2. get_planning_event si l'utilisateur veut l'adresse du chantier ou les devis liés à une intervention.

Exemple d'arguments

{
  "from": "2026-11-23",
  "to": "2026-11-29",
  "limit": 25
}

Résultat. Le planning jour par jour, par personne ou par chantier selon la demande.

4. Lire un document d'un dossier

Lecture

Demande

« Que prévoit l'offre du fournisseur de châssis classée dans le dossier Dupont ? Quel est le délai de livraison ? »

Ce que fait l'assistant

  1. search_dossiers puis list_dossier_documents avec query: "châssis".
  2. read_document sur l'offre : texte du PDF par tranches de 20 pages au plus ; l'assistant lit la suite avec part = nextPart si nécessaire.

Résultat. Les éléments de l'offre (prix, délai, conditions) cités du document. Une page scannée sans texte est signalée, pas inventée.

Contenu externe

Le texte d'un document ou d'un courriel est une donnée : le serveur le nettoie, et ses instructions demandent au modèle de ne jamais exécuter une consigne qui y figurerait.

5. Mes courriels et mes tâches

Lecture

Demande

« Résume mes mails non lus et dis-moi quelles tâches urgentes je dois traiter aujourd'hui. »

Ce que fait l'assistant

  1. get_my_emails avec unreadOnly: true, puis get_email pour le corps des courriels importants (sans les marquer comme lus).
  2. get_my_tasks : tâches reçues à traiter, urgentes d'abord.

Résultat. Une synthèse des courriels non lus et la liste des tâches urgentes, avec leur dossier.

Agir (outils d'écriture)

Ces exemples exigent que la société ait activé les outils d'écriture (Connexion).

6. Rédiger un devis

Écriture

Demande

« Prépare un devis pour le dossier Dupont : pose de 25 m² de carrelage 60×60 avec la colle, plus la dépose de l'ancien carrelage (6 h). »

Ce que fait l'assistant

  1. search_dossiers et search_items pour trouver le dossier, le carrelage et la colle dans le catalogue.
  2. L'assistant annonce le devis qu'il va créer et les lignes qu'il va ajouter, et attend votre accord.
  3. create_estimate sur le dossier, puis add_estimate_lines : un titre, deux articles du catalogue, une ligne de main-d'œuvre.

Exemple d'arguments

{
  "estimateId": 4812,
  "lines": [
    {
      "kind": "title",
      "name": "Carrelage salle de bains"
    },
    {
      "kind": "item",
      "itemId": 2290,
      "quantity": 25
    },
    {
      "kind": "item",
      "itemId": 2307,
      "quantity": 5
    },
    {
      "kind": "free",
      "name": "Dépose de l'ancien carrelage",
      "category": "workforce",
      "quantity": 6,
      "unitPrice": 48
    }
  ]
}

Résultat. Un devis à éditer dans Oxygenius. Prix, TVA et totaux sont calculés par Oxygenius comme dans l'écran du devis : l'assistant n'envoie jamais de montant calculé. Rien n'est envoyé au client.

Prérequis

La société a activé les outils d'écriture, et l'utilisateur a les permissions dossier-detail.estimate.create et estimate.list.view.

7. Numéroter une facture et l'envoyer au client

Écriture

Demande

« Numérote la facture d'acompte du dossier Dupont et envoie-la au client. »

Ce que fait l'assistant

  1. search_invoices avec dossierId pour trouver le brouillon.
  2. prepare_invoice_finalization : ne change rien, montre le numéro légal à venir, les effets (PDF, UBL, écriture comptable, envoi automatique au comptable si la société l'a réglé) et les points d'attention (date, échéance, total nul), avec un jeton de 10 minutes.
  3. Après votre accord explicite : finalize_invoice avec le jeton.
  4. create_document_email avec kind: "invoice" : le brouillon de courriel de la société, PDF joint.
  5. prepare_email_send : le courriel exactement tel qu'il partira (expéditeur, destinataires, objet, message, pièces jointes, avertissements).
  6. Après votre accord explicite sur ce courriel : send_email avec le jeton.

Résultat. La facture est numérotée et envoyée ; elle passe au statut Envoyé. Un document modifié entre la préparation et l'action fait refuser le jeton : il faut préparer à nouveau.

Actions irréversibles

Le numéro d'une facture est légal et définitif, un courriel envoyé ne se rappelle pas. Ces outils sont marqués destructifs : Claude demande toujours une approbation, en plus de l'accord donné à l'assistant. Les envois sont plafonnés à 30 par utilisateur et par jour.

8. Adresser une tâche à un collègue

Écriture

Demande

« Demande à Julie de commander les tuiles pour le chantier Dupont, c'est urgent. »

Ce que fait l'assistant

  1. search_users avec query: "Julie" et taskRecipientsOnly: true.
  2. list_task_types avec assigneeId : les types de tâche qu'on peut lui adresser.
  3. L'assistant annonce la tâche (destinataire, type, dossier, contenu, urgence) et attend votre accord, puis appelle create_task.

Exemple d'arguments

{
  "assigneeIds": [
    37
  ],
  "taskTypeId": 4,
  "dossierId": 1186,
  "description": "Commander les tuiles pour le chantier Dupont.",
  "isUrgent": true
}

Résultat. Julie reçoit la tâche, épinglée comme urgente, et est notifiée par Oxygenius.