Ce que vous pouvez demander

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 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, avec `ACM-12` comme élément de travail
« Passez ACM-12 en Terminé. »	POST /work-items/{work_item}/actions/transition, après avoir cherché le statut Terminé avec GET /workflow-statuses. 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 avec `minutes: 90`, après avoir trouvé le projet avec GET /projects
« Combien d'heures ai-je saisies cette semaine ? »	GET /worklogs 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 avec `timeable_type: work_item`, après avoir lu ACM-12 avec GET /work-items/{work_item} pour obtenir son id

Planification

Vous demandez	L'assistant utilise
« Qu'est-ce que j'ai dans mon agenda la semaine prochaine ? »	GET /events 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

Congés

Vous demandez	L'assistant utilise
« Qui est absent la semaine prochaine ? »	GET /absences avec `filter[start]` et `filter[end]`
« Quels jours sommes-nous fermés d'ici la fin de l'année ? »	GET /free-days 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} avec `mode: append`, après avoir trouvé le document avec GET /drive-items
« Résumez le document Kick-off Acme. »	GET /drive-documents/{drive_document}

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 pour trouver Acme, puis GET /contacts filtré sur ce client
« Quels projets menons-nous pour Acme ? »	GET /projects 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 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, après avoir trouvé l'itération avec GET /sprints
« Qu'est-ce qui reste ouvert dans l'itération en cours ? »	GET /work-items 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é explique comment cela fonctionne.