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.
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
search_invoices avec state: "overdue" : solde restant dû et retard recalculés (montant à payer − notes de crédit − paiements).
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
search_planning_events sur la période : une occurrence par jour avec les personnes affectées, en heure locale belge.
get_planning_event si l'utilisateur veut l'adresse du chantier ou les devis liés à une intervention.
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
get_my_emails avec unreadOnly: true, puis get_email pour le corps des courriels importants (sans les marquer comme lus).
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.
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. »
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.
create_document_email avec kind: "invoice" : le brouillon de courriel de la société, PDF joint.
prepare_email_send : le courriel exactement tel qu'il partira (expéditeur, destinataires, objet, message, pièces jointes, avertissements).
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
search_users avec query: "Julie" et taskRecipientsOnly: true.
list_task_types avec assigneeId : les types de tâche qu'on peut lui adresser.
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.