# Wat je kunt vragen Voorbeeldvragen per onderdeel voor een AI-assistent die aan plnnrly is gekoppeld, met de operatie van de REST API die elke vraag gebruikt. Is er een assistent gekoppeld, dan vraag je in je eigen woorden wat je wilt. De voorbeelden hieronder laten per onderdeel van plnnrly zien wat hij kan. Naast elke vraag staat de operatie die de assistent aanroept, met een link naar de pagina in de API-referentie (in het Engels). Zo zie je precies wat er gebeurt. De assistent werkt namens jou, dus hij kan alleen wat je rol toestaat. ## Mijn werk | Je vraagt | De assistent gebruikt | | --------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | "Welke werkitems zijn aan mij toegewezen en nog niet klaar?" | [GET /work-items](https://developers.plnnrly.com/en/docs/api/v2/work-items/list/) met `filter[assignee_id]=me` en `filter[resolved]=false` | | "Plaats een reactie bij ACM-12: we wachten nog op de teksten van de klant." | [POST /work-items/{work_item}/comments](https://developers.plnnrly.com/en/docs/api/v2/work-items/comments/create/), met `ACM-12` als werkitem | | "Zet ACM-12 op Done." | [POST /work-items/{work_item}/actions/transition](https://developers.plnnrly.com/en/docs/api/v2/work-items/transition/), nadat hij de status Done heeft opgezocht met [GET /workflow-statuses](https://developers.plnnrly.com/en/docs/api/v2/workflow-statuses/list/). Alleen als je organisatie sprints gebruikt, want de workflowstatussen horen bij sprints. | ## Tijd | Je vraagt | De assistent gebruikt | | ------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | "Schrijf voor gisteren anderhalf uur op het project Website: review van het ontwerp." | [POST /worklogs](https://developers.plnnrly.com/en/docs/api/v2/worklogs/create/) met `minutes: 90`, nadat hij het project heeft gevonden met [GET /projects](https://developers.plnnrly.com/en/docs/api/v2/projects/list/) | | "Hoeveel uur heb ik deze week geschreven?" | [GET /worklogs](https://developers.plnnrly.com/en/docs/api/v2/worklogs/list/) met een periode. Je krijgt je eigen uren, tenzij je iemand anders noemt. | | "Start een timer op ACM-12." | [POST /timers](https://developers.plnnrly.com/en/docs/api/v2/timers/create/) met `timeable_type: work_item`, nadat hij ACM-12 heeft gelezen met [GET /work-items/{work_item}](https://developers.plnnrly.com/en/docs/api/v2/work-items/get/) om de id te krijgen | ## Planning | Je vraagt | De assistent gebruikt | | ------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | "Wat staat er volgende week in mijn agenda?" | [GET /events](https://developers.plnnrly.com/en/docs/api/v2/events/list/) met `filter[start][gte]` en `filter[start][lte]`. Je krijgt je eigen afspraken. | | "Zet donderdag van 14:00 tot 15:00 een review van ACM-12 in mijn agenda." | [POST /events](https://developers.plnnrly.com/en/docs/api/v2/events/create/) | ## Verlof | Je vraagt | De assistent gebruikt | | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | | "Wie is er volgende week afwezig?" | [GET /absences](https://developers.plnnrly.com/en/docs/api/v2/absences/list/) met `filter[start]` en `filter[end]` | | "Op welke dagen zijn we de rest van dit jaar gesloten?" | [GET /free-days](https://developers.plnnrly.com/en/docs/api/v2/free-days/list/) met `filter[date][gte]` | Voor afwezigheden heb je het recht **Afwezigheden beheren** nodig, en voor vrije dagen **Bedrijfsbrede vrije dagen beheren**. ## Drive | Je vraagt | De assistent gebruikt | | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | "Voeg deze vergadernotities toe aan het document Kick-off Acme." | [PATCH /drive-documents/{drive_document}](https://developers.plnnrly.com/en/docs/api/v2/drive-documents/update/) met `mode: append`, nadat hij het document heeft gevonden met [GET /drive-items](https://developers.plnnrly.com/en/docs/api/v2/drive-items/list/) | | "Vat het document Kick-off Acme samen." | [GET /drive-documents/{drive_document}](https://developers.plnnrly.com/en/docs/api/v2/drive-documents/get/) | Met `mode: append` komen de notities na de bestaande tekst, en verandert er niets aan wat er al stond. ## Klanten | Je vraagt | De assistent gebruikt | | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | "Wie zijn de contactpersonen bij Acme?" | [GET /customers](https://developers.plnnrly.com/en/docs/api/v2/customers/list/) om Acme te vinden, daarna [GET /contacts](https://developers.plnnrly.com/en/docs/api/v2/contacts/list/) gefilterd op die klant | | "Welke projecten doen we voor Acme?" | [GET /projects](https://developers.plnnrly.com/en/docs/api/v2/projects/list/) met `filter[customer_id]` | ## Facturatie Alleen als je organisatie facturatie gebruikt. | Je vraagt | De assistent gebruikt | | --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | | "Welke verkoopfacturen voor Acme zijn nog concept?" | [GET /sales-invoices](https://developers.plnnrly.com/en/docs/api/v2/sales-invoices/list/) met `filter[status]=draft` en `filter[customer_id]` | ## Sprints Alleen als je projecten met sprints werken. | Je vraagt | De assistent gebruikt | | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | "Start de volgende sprint van het project Website." | [POST /sprints/{sprint}/actions/start](https://developers.plnnrly.com/en/docs/api/v2/sprints/start/), nadat hij de sprint heeft gevonden met [GET /sprints](https://developers.plnnrly.com/en/docs/api/v2/sprints/list/) | | "Wat staat er nog open in de huidige sprint?" | [GET /work-items](https://developers.plnnrly.com/en/docs/api/v2/work-items/list/) met `filter[sprint_id]` en `filter[resolved]=false` | ## Tips - Gebruik de sleutel van een werkitem, zoals ACM-12. De assistent kan die in paden voor werkitems gebruiken, en zoekt zelf het nummer op waar hij dat nodig heeft. - Zeg "mij" of "mijn". De assistent kan dan op jou filteren zonder je naam op te zoeken. - Noem het project of de klant, zodat de assistent niet hoeft te raden. - Vraag de assistent om te laten zien wat hij gaat wijzigen, voordat hij iets schrijft. - Vraag bij lange lijsten om minder rijen of om een samenvatting. Antwoorden hebben een maximale grootte, en de assistent hoort het als een lijst is ingekort. ## Wat hij niet doet - Bestanden uploaden, zoals bijlagen of Drive-bestanden. - Iets verwijderen zonder jouw bevestiging en zonder toestemming van je organisatie. - Iets doen wat je rol in plnnrly niet toestaat. [Rechten en veiligheid](https://developers.plnnrly.com/nl/docs/mcp/permissions-and-safety/) legt uit hoe dit werkt.