# Was Sie fragen können Beispielfragen für einen mit plnnrly verbundenen KI-Assistenten, nach Bereich, jeweils mit der Operation der REST-API, die er nutzt. Sobald ein Assistent verbunden ist, fragen Sie in Ihren eigenen Worten. Die Beispiele unten zeigen für jeden Bereich von plnnrly, was er kann. Neben jeder Frage steht die Operation, die der Assistent aufruft, mit einem Link auf ihre Seite in der API-Referenz (Englisch). So sehen Sie genau, was passiert. Der Assistent arbeitet in Ihrem Namen und kann deshalb nur, was Ihre Rolle erlaubt. ## Meine Arbeit | Sie fragen | Der Assistent nutzt | | -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | „Welche Arbeitselemente sind mir zugewiesen und noch nicht erledigt?“ | [GET /work-items](https://developers.plnnrly.com/en/docs/api/v2/work-items/list/) mit `filter[assignee_id]=me` und `filter[resolved]=false` | | „Schreiben Sie bei ACM-12 einen Kommentar: Wir warten auf die Texte vom Kunden.“ | [POST /work-items/{work_item}/comments](https://developers.plnnrly.com/en/docs/api/v2/work-items/comments/create/), mit `ACM-12` als Arbeitselement | | „Setzen Sie ACM-12 auf Erledigt.“ | [POST /work-items/{work_item}/actions/transition](https://developers.plnnrly.com/en/docs/api/v2/work-items/transition/), nachdem er den Status Erledigt mit [GET /workflow-statuses](https://developers.plnnrly.com/en/docs/api/v2/workflow-statuses/list/) nachgeschlagen hat. Nur wenn Ihre Organisation Iterationen nutzt, denn zu ihnen gehören die Ablaufstatus. | ## Zeit | Sie fragen | Der Assistent nutzt | | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | „Buchen Sie für gestern anderthalb Stunden auf das Projekt Website: Design-Review.“ | [POST /worklogs](https://developers.plnnrly.com/en/docs/api/v2/worklogs/create/) mit `minutes: 90`, nachdem er das Projekt mit [GET /projects](https://developers.plnnrly.com/en/docs/api/v2/projects/list/) gefunden hat | | „Wie viele Stunden habe ich diese Woche gebucht?“ | [GET /worklogs](https://developers.plnnrly.com/en/docs/api/v2/worklogs/list/) mit einem Datumsbereich. Der Aufruf liefert Ihre eigenen Stunden, es sei denn, Sie nennen jemand anderen. | | „Starten Sie einen Timer für ACM-12.“ | [POST /timers](https://developers.plnnrly.com/en/docs/api/v2/timers/create/) mit `timeable_type: work_item`, nachdem er ACM-12 mit [GET /work-items/{work_item}](https://developers.plnnrly.com/en/docs/api/v2/work-items/get/) gelesen hat, um seine ID zu bekommen | ## Planung | Sie fragen | Der Assistent nutzt | | -------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | „Was steht nächste Woche in meinem Kalender?“ | [GET /events](https://developers.plnnrly.com/en/docs/api/v2/events/list/) mit `filter[start][gte]` und `filter[start][lte]`. Der Aufruf liefert Ihre eigenen Termine. | | „Tragen Sie mir für Donnerstag von 14:00 bis 15:00 Uhr ein Review von ACM-12 in den Kalender ein.“ | [POST /events](https://developers.plnnrly.com/en/docs/api/v2/events/create/) | ## Abwesenheiten | Sie fragen | Der Assistent nutzt | | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | | „Wer ist nächste Woche abwesend?“ | [GET /absences](https://developers.plnnrly.com/en/docs/api/v2/absences/list/) mit `filter[start]` und `filter[end]` | | „An welchen Tagen haben wir in diesem Jahr noch geschlossen?“ | [GET /free-days](https://developers.plnnrly.com/en/docs/api/v2/free-days/list/) mit `filter[date][gte]` | Für Abwesenheiten braucht man das Recht **Abwesenheiten verwalten**, für freie Tage das Recht **Unternehmensweite freie Tage verwalten**. ## Drive | Sie fragen | Der Assistent nutzt | | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | „Fügen Sie diese Besprechungsnotizen zum Dokument Kick-off Acme hinzu.“ | [PATCH /drive-documents/{drive_document}](https://developers.plnnrly.com/en/docs/api/v2/drive-documents/update/) mit `mode: append`, nachdem er das Dokument mit [GET /drive-items](https://developers.plnnrly.com/en/docs/api/v2/drive-items/list/) gefunden hat | | „Fassen Sie das Dokument Kick-off Acme zusammen.“ | [GET /drive-documents/{drive_document}](https://developers.plnnrly.com/en/docs/api/v2/drive-documents/get/) | Mit `mode: append` werden die Notizen an den vorhandenen Text angehängt; was schon da ist, bleibt unverändert. ## Kunden | Sie fragen | Der Assistent nutzt | | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | „Wer sind die Kontakte bei Acme?“ | [GET /customers](https://developers.plnnrly.com/en/docs/api/v2/customers/list/), um Acme zu finden, dann [GET /contacts](https://developers.plnnrly.com/en/docs/api/v2/contacts/list/), nach diesem Kunden gefiltert | | „Welche Projekte machen wir für Acme?“ | [GET /projects](https://developers.plnnrly.com/en/docs/api/v2/projects/list/) mit `filter[customer_id]` | ## Abrechnung Nur wenn Ihre Organisation die Abrechnung nutzt. | Sie fragen | Der Assistent nutzt | | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | „Welche Verkaufsrechnungen für Acme sind noch Entwürfe?“ | [GET /sales-invoices](https://developers.plnnrly.com/en/docs/api/v2/sales-invoices/list/) mit `filter[status]=draft` und `filter[customer_id]` | ## Iterationen Nur wenn Ihre Projekte mit Iterationen arbeiten. | Sie fragen | Der Assistent nutzt | | ------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | „Starten Sie die nächste Iteration im Projekt Website.“ | [POST /sprints/{sprint}/actions/start](https://developers.plnnrly.com/en/docs/api/v2/sprints/start/), nachdem er die Iteration mit [GET /sprints](https://developers.plnnrly.com/en/docs/api/v2/sprints/list/) gefunden hat | | „Was ist in der aktuellen Iteration noch offen?“ | [GET /work-items](https://developers.plnnrly.com/en/docs/api/v2/work-items/list/) mit `filter[sprint_id]` und `filter[resolved]=false` | ## Tipps - Verwenden Sie Schlüssel wie ACM-12. Der Assistent kann sie in den Pfaden von Arbeitselementen verwenden und sucht die Nummer selbst heraus, wo er eine braucht. - Sagen Sie „ich“, „mir“ oder „mein“. Der Assistent kann nach Ihnen filtern, ohne Ihren Namen nachzuschlagen. - Nennen Sie das Projekt oder den Kunden, damit der Assistent nicht raten muss. - Bitten Sie den Assistenten, zu zeigen, was er ändern wird, bevor er etwas schreibt. - Bitten Sie bei langen Listen um weniger Zeilen oder eine Zusammenfassung. Antworten haben eine Höchstgröße, und der Assistent erfährt, wenn eine Liste gekürzt wurde. ## Was er nicht tut - Dateien hochladen, etwa Anhänge oder Drive-Dateien. - Ohne Ihre Bestätigung und die Erlaubnis Ihrer Organisation etwas löschen. - Etwas tun, was Ihre Rolle in plnnrly nicht erlaubt. [Rechte und Sicherheit](https://developers.plnnrly.com/de/docs/mcp/permissions-and-safety/) erklärt, wie das funktioniert.