# Ce que vous pouvez demander Des exemples de questions pour un assistant IA connecté à plnnrly, regroupés par thème, avec l'opération de l'API REST que chacune utilise. Une fois l'assistant connecté, vous lui parlez avec vos propres mots. Les exemples ci-dessous montrent ce qu'il peut faire, pour chaque partie de plnnrly. À côté de chaque question figure l'opération que l'assistant appelle, avec un lien vers sa page dans la référence de l'API (en anglais) : vous voyez ainsi exactement ce qui se passe. L'assistant travaille en votre nom : il ne peut faire que ce que votre rôle permet. ## Mon travail | Vous demandez | L'assistant utilise | | ------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | « Quels éléments de travail me sont assignés et ne sont pas encore terminés ? » | [GET /work-items](https://developers.plnnrly.com/en/docs/api/v2/work-items/list/) avec `filter[assignee_id]=me` et `filter[resolved]=false` | | « Ajoutez un commentaire sur ACM-12 : en attente des textes du client. » | [POST /work-items/{work_item}/comments](https://developers.plnnrly.com/en/docs/api/v2/work-items/comments/create/), avec `ACM-12` comme élément de travail | | « Passez ACM-12 en Terminé. » | [POST /work-items/{work_item}/actions/transition](https://developers.plnnrly.com/en/docs/api/v2/work-items/transition/), après avoir cherché le statut Terminé avec [GET /workflow-statuses](https://developers.plnnrly.com/en/docs/api/v2/workflow-statuses/list/). Uniquement si votre organisation utilise les itérations, qui apportent les statuts de flux de travail. | ## Temps | Vous demandez | L'assistant utilise | | -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | « Enregistrez une heure et demie sur le projet Site web pour hier : revue du design. » | [POST /worklogs](https://developers.plnnrly.com/en/docs/api/v2/worklogs/create/) avec `minutes: 90`, après avoir trouvé le projet avec [GET /projects](https://developers.plnnrly.com/en/docs/api/v2/projects/list/) | | « Combien d'heures ai-je saisies cette semaine ? » | [GET /worklogs](https://developers.plnnrly.com/en/docs/api/v2/worklogs/list/) avec une plage de dates. Il renvoie vos propres heures, sauf si vous nommez quelqu'un d'autre. | | « Lancez le chrono sur ACM-12. » | [POST /timers](https://developers.plnnrly.com/en/docs/api/v2/timers/create/) avec `timeable_type: work_item`, après avoir lu ACM-12 avec [GET /work-items/{work_item}](https://developers.plnnrly.com/en/docs/api/v2/work-items/get/) pour obtenir son id | ## Planification | Vous demandez | L'assistant utilise | | --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | « Qu'est-ce que j'ai dans mon agenda la semaine prochaine ? » | [GET /events](https://developers.plnnrly.com/en/docs/api/v2/events/list/) avec `filter[start][gte]` et `filter[start][lte]`. Il renvoie vos propres événements. | | « Ajoutez une revue d'ACM-12 dans mon agenda jeudi, de 14 h à 15 h. » | [POST /events](https://developers.plnnrly.com/en/docs/api/v2/events/create/) | ## Congés | Vous demandez | L'assistant utilise | | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------- | | « Qui est absent la semaine prochaine ? » | [GET /absences](https://developers.plnnrly.com/en/docs/api/v2/absences/list/) avec `filter[start]` et `filter[end]` | | « Quels jours sommes-nous fermés d'ici la fin de l'année ? » | [GET /free-days](https://developers.plnnrly.com/en/docs/api/v2/free-days/list/) avec `filter[date][gte]` | Les absences demandent le droit **Gérer les absences**, et les jours offerts le droit **Gérer les jours offerts à l'échelle de l'entreprise**. ## Drive | Vous demandez | L'assistant utilise | | ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | « Ajoutez ces notes de réunion au document Kick-off Acme. » | [PATCH /drive-documents/{drive_document}](https://developers.plnnrly.com/en/docs/api/v2/drive-documents/update/) avec `mode: append`, après avoir trouvé le document avec [GET /drive-items](https://developers.plnnrly.com/en/docs/api/v2/drive-items/list/) | | « Résumez le document Kick-off Acme. » | [GET /drive-documents/{drive_document}](https://developers.plnnrly.com/en/docs/api/v2/drive-documents/get/) | Avec `mode: append`, les notes sont ajoutées après le texte existant, et rien de ce qui s'y trouve déjà ne change. ## Clients | Vous demandez | L'assistant utilise | | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | « Qui sont les contacts chez Acme ? » | [GET /customers](https://developers.plnnrly.com/en/docs/api/v2/customers/list/) pour trouver Acme, puis [GET /contacts](https://developers.plnnrly.com/en/docs/api/v2/contacts/list/) filtré sur ce client | | « Quels projets menons-nous pour Acme ? » | [GET /projects](https://developers.plnnrly.com/en/docs/api/v2/projects/list/) avec `filter[customer_id]` | ## Facturation Uniquement si votre organisation utilise la facturation. | Vous demandez | L'assistant utilise | | -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | « Quelles factures de vente pour Acme sont encore des brouillons ? » | [GET /sales-invoices](https://developers.plnnrly.com/en/docs/api/v2/sales-invoices/list/) avec `filter[status]=draft` et `filter[customer_id]` | ## Itérations Uniquement si vos projets fonctionnent en itérations. | Vous demandez | L'assistant utilise | | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | « Démarrez la prochaine itération du projet Site web. » | [POST /sprints/{sprint}/actions/start](https://developers.plnnrly.com/en/docs/api/v2/sprints/start/), après avoir trouvé l'itération avec [GET /sprints](https://developers.plnnrly.com/en/docs/api/v2/sprints/list/) | | « Qu'est-ce qui reste ouvert dans l'itération en cours ? » | [GET /work-items](https://developers.plnnrly.com/en/docs/api/v2/work-items/list/) avec `filter[sprint_id]` et `filter[resolved]=false` | ## Conseils - Utilisez les clés des éléments de travail, comme ACM-12. L'assistant peut les utiliser dans les chemins des éléments de travail, et il cherche lui-même le numéro quand il en a besoin. - Dites « moi » ou « mes ». L'assistant peut filtrer sur vous sans chercher votre nom. - Nommez le projet ou le client, pour que l'assistant n'ait pas à deviner. - Demandez à l'assistant de montrer ce qu'il va modifier avant qu'il n'écrive quoi que ce soit. - Pour les longues listes, demandez moins de lignes ou un résumé. Les réponses ont une taille maximale, et l'assistant est prévenu quand une liste a été tronquée. ## Ce qu'il ne fera pas - Envoyer des fichiers, comme des pièces jointes ou des fichiers Drive. - Supprimer quoi que ce soit sans votre confirmation et l'autorisation de votre organisation. - Faire ce que votre rôle ne permet pas dans plnnrly. La page [Droits et sécurité](https://developers.plnnrly.com/fr/docs/mcp/permissions-and-safety/) explique comment cela fonctionne.