# Qué puedes pedir Preguntas de ejemplo para un asistente de IA conectado a plnnrly, por área, con la operación de la API REST que usa cada una. Una vez conectado un asistente, le pides las cosas con tus propias palabras. Los ejemplos de abajo muestran lo que puede hacer en cada área de plnnrly. Junto a cada pregunta está la operación que llama el asistente, con un enlace a su página en la referencia de la API (en inglés), para que veas exactamente qué ocurre. El asistente trabaja en tu nombre, así que solo puede hacer lo que permite tu rol. ## Mi trabajo | Lo que pides | Lo que usa el asistente | | ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | «¿Qué elementos de trabajo tengo asignados que aún no estén terminados?» | [GET /work-items](https://developers.plnnrly.com/en/docs/api/v2/work-items/list/) con `filter[assignee_id]=me` y `filter[resolved]=false` | | «Añade un comentario a ACM-12: esperando los textos del cliente.» | [POST /work-items/{work_item}/comments](https://developers.plnnrly.com/en/docs/api/v2/work-items/comments/create/), con `ACM-12` como elemento de trabajo | | «Mueve ACM-12 a Hecho.» | [POST /work-items/{work_item}/actions/transition](https://developers.plnnrly.com/en/docs/api/v2/work-items/transition/), después de buscar el estado Hecho con [GET /workflow-statuses](https://developers.plnnrly.com/en/docs/api/v2/workflow-statuses/list/). Solo si tu organización usa iteraciones, que son las que traen los estados del flujo de trabajo. | ## Horas | Lo que pides | Lo que usa el asistente | | -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | «Registra una hora y media de ayer en el proyecto Website: revisión del diseño.» | [POST /worklogs](https://developers.plnnrly.com/en/docs/api/v2/worklogs/create/) con `minutes: 90`, después de encontrar el proyecto con [GET /projects](https://developers.plnnrly.com/en/docs/api/v2/projects/list/) | | «¿Cuántas horas he registrado esta semana?» | [GET /worklogs](https://developers.plnnrly.com/en/docs/api/v2/worklogs/list/) con un intervalo de fechas. Devuelve tus propias horas, salvo que nombres a otra persona. | | «Inicia un cronómetro en ACM-12.» | [POST /timers](https://developers.plnnrly.com/en/docs/api/v2/timers/create/) con `timeable_type: work_item`, después de leer ACM-12 con [GET /work-items/{work_item}](https://developers.plnnrly.com/en/docs/api/v2/work-items/get/) para obtener su id | ## Planificación | Lo que pides | Lo que usa el asistente | | --------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | «¿Qué tengo en el calendario la semana que viene?» | [GET /events](https://developers.plnnrly.com/en/docs/api/v2/events/list/) con `filter[start][gte]` y `filter[start][lte]`. Devuelve tus propios eventos. | | «Ponme una revisión de ACM-12 en el calendario el jueves de 14:00 a 15:00.» | [POST /events](https://developers.plnnrly.com/en/docs/api/v2/events/create/) | ## Ausencias | Lo que pides | Lo que usa el asistente | | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | | «¿Quién está ausente la semana que viene?» | [GET /absences](https://developers.plnnrly.com/en/docs/api/v2/absences/list/) con `filter[start]` y `filter[end]` | | «¿Qué días cerramos en lo que queda de año?» | [GET /free-days](https://developers.plnnrly.com/en/docs/api/v2/free-days/list/) con `filter[date][gte]` | Las ausencias necesitan el permiso **Gestionar ausencias**, y los días libres, **Gestionar días libres a nivel de empresa**. ## Drive | Lo que pides | Lo que usa el asistente | | ------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | «Añade estas notas de la reunión al documento Kick-off Acme.» | [PATCH /drive-documents/{drive_document}](https://developers.plnnrly.com/en/docs/api/v2/drive-documents/update/) con `mode: append`, después de encontrar el documento con [GET /drive-items](https://developers.plnnrly.com/en/docs/api/v2/drive-items/list/) | | «Resume el documento Kick-off Acme.» | [GET /drive-documents/{drive_document}](https://developers.plnnrly.com/en/docs/api/v2/drive-documents/get/) | Con `mode: append`, las notas se añaden después del texto existente y no cambia nada de lo que ya había. ## Clientes | Lo que pides | Lo que usa el asistente | | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | «¿Quiénes son los contactos de Acme?» | [GET /customers](https://developers.plnnrly.com/en/docs/api/v2/customers/list/) para encontrar Acme y después [GET /contacts](https://developers.plnnrly.com/en/docs/api/v2/contacts/list/) filtrado por ese cliente | | «¿Qué proyectos llevamos para Acme?» | [GET /projects](https://developers.plnnrly.com/en/docs/api/v2/projects/list/) con `filter[customer_id]` | ## Facturación Solo si tu organización usa la facturación. | Lo que pides | Lo que usa el asistente | | ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | «¿Qué facturas de venta de Acme siguen en borrador?» | [GET /sales-invoices](https://developers.plnnrly.com/en/docs/api/v2/sales-invoices/list/) con `filter[status]=draft` y `filter[customer_id]` | ## Iteraciones Solo si tus proyectos trabajan con iteraciones. | Lo que pides | Lo que usa el asistente | | ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | «Inicia la siguiente iteración del proyecto Website.» | [POST /sprints/{sprint}/actions/start](https://developers.plnnrly.com/en/docs/api/v2/sprints/start/), después de encontrar la iteración con [GET /sprints](https://developers.plnnrly.com/en/docs/api/v2/sprints/list/) | | «¿Qué queda pendiente en la iteración actual?» | [GET /work-items](https://developers.plnnrly.com/en/docs/api/v2/work-items/list/) con `filter[sprint_id]` y `filter[resolved]=false` | ## Consejos - Usa claves como ACM-12. El asistente puede usarlas en las rutas de los elementos de trabajo, y busca él mismo el número cuando lo necesita. - Habla en primera persona («mis horas», «tengo asignados»). El asistente puede filtrar por ti sin buscar tu nombre. - Nombra el proyecto o el cliente, para que el asistente no tenga que adivinarlo. - Pide al asistente que te enseñe lo que va a cambiar antes de que escriba nada. - Para listas largas, pide menos filas o un resumen. Las respuestas tienen un tamaño máximo, y al asistente se le avisa cuando una lista se ha cortado. ## Lo que no hará - Subir archivos, como adjuntos o archivos de Drive. - Eliminar nada sin tu confirmación y el permiso de tu organización. - Nada que tu rol no pueda hacer en plnnrly. [Permisos y seguridad](https://developers.plnnrly.com/es/docs/mcp/permissions-and-safety/) explica cómo funciona.