Calendario

Obtener la agenda de un rango

Devuelve la agenda consolidada de una ventana: proyectos, pedidos, tareas, servicios internos y servicios de pedido.

Herramienta

filmo_schedule_get

Lecturaschedule:read

schedule:read
120/min
Anotación del servidor: Solo lectura
Anotación del servidor: Idempotente

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_schedule_get",
    "arguments": {
      "startDate": "2026-09-01T08:00:00Z",
      "endDate": "2026-09-01T08:00:00Z"
    }
  }
}

{
  "structuredContent": {
    "data": {
      "projects": [
        {
          "id": "id_8f2a1c",
          "name": "Example",
          "startDate": "2026-09-01T08:00:00Z",
          "endDate": "2026-09-01T08:00:00Z",
          "status": "<status>"
        }
      ],
      "orders": [
        {
          "id": "id_8f2a1c",
          "orderNumber": "<orderNumber>",
          "startDate": "2026-09-01T08:00:00Z",
          "endDate": "2026-09-01T08:00:00Z",
          "status": "<status>",
          "contactName": "Example",
          "projectName": "Example"
        }
      ],
      "tasks": [
        {
          "id": "id_8f2a1c",
          "title": "Example",
          "startDate": "2026-09-01T08:00:00Z",
          "endDate": "2026-09-01T08:00:00Z",
          "isAllDay": true,
          "isCompleted": true,
          "type": "<type>",
          "projectId": "proj_8f2a1c",
          "assignedStaff": [
            {
              "id": "id_8f2a1c",
              "fullName": "Example"
            }
          ]
        }
      ],
      "internalServices": [
        {
          "id": "id_8f2a1c",
          "title": "Example",
          "serviceType": "<serviceType>",
          "startDate": "2026-09-01T08:00:00Z",
          "endDate": "2026-09-01T08:00:00Z",
          "projectName": "Example",
          "qty": 1,
          "assignedStaff": [
            {
              "id": "id_8f2a1c",
              "fullName": "Example"
            }
          ],
          "assignedVehicleIds": [
            "assi_8f2a1c"
          ]
        }
      ],
      "orderServices": [
        {
          "orderId": "orde_8f2a1c",
          "orderNumber": "<orderNumber>",
          "serviceName": "Example",
          "serviceType": "<serviceType>",
          "startDate": "2026-09-01T08:00:00Z",
          "endDate": "2026-09-01T08:00:00Z",
          "contactName": "Example",
          "projectName": "Example",
          "qty": 1,
          "assignedCount": 1,
          "assignedStaff": [
            {
              "id": "id_8f2a1c",
              "fullName": "Example"
            }
          ]
        }
      ]
    },
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}

generado desde el esquema

No pagina: está acotada por fechas, que es lo que pide un calendario, pero cada capa tiene un tope y la respuesta no indica cuándo se ha cortado: como máximo 200 proyectos, 200 pedidos y 500 tareas, ordenados por fecha de inicio, de modo que una capa que devuelve exactamente su tope puede estar truncada (usa una ventana más corta). Solo aparecen los registros activos: proyectos en draft, budgeted, confirmed o in_progress, y pedidos en draft, reserved, prepared_partially, prepared, picked_up_partially, picked_up, returned_partially, returned o checked_in_partially; un pedido checked_in, cancelado o archivado no se devuelve. Por tanto, no es una instantánea completa: no borres un registro solo porque falte. Las personas asignadas salen por identificador y nombre; sus datos de contacto no.

Argumentos

startDatestring<date-time>Obligatorio

Inicio de la ventana, en ISO 8601 con desplazamiento.

endDatestring<date-time>Obligatorio

Fin de la ventana, en ISO 8601 con desplazamiento.

layersstring[]

Qué capas obtener: projects, orders, tasks, internal_services u order_services. Por defecto, todas. Repite el parámetro o separa los valores con comas para indicar varias.

Opciones disponibles: projects, orders, tasks, internal_services, order_services

Límites: mín. 1 elementos, máx. 50 elementos

projectStatusstring[]

Filtra los proyectos por estado.

Límites: mín. 1 elementos, máx. 50 elementos

orderStatusstring[]

Filtra los pedidos por estado.

Límites: mín. 1 elementos, máx. 50 elementos

assignedToStaffIdsstring[]

Conserva solo lo asignado a estos miembros del personal.

Límites: mín. 1 elementos, máx. 200 elementos

Resultado

En un éxito el resultado lleva structuredContent con data y meta. Estos son los atributos de data.

Ver los atributos de data

projectsobject[]

Proyectos que caen dentro de la ventana.

Mostrar atributos hijos

projects.idstring

projects.namestring

projects.startDatestring<date-time>

projects.endDatestring<date-time>

projects.statusstring

ordersobject[]

Pedidos que caen dentro de la ventana.

Mostrar atributos hijos

orders.idstring

orders.orderNumberstring

orders.startDatestring<date-time>

orders.endDatestring<date-time>

orders.statusstring

orders.contactNamestring | null

orders.projectNamestring | null

tasksobject[]

Tareas del planificador. Sin los datos de contacto de las personas a las que están asignadas.

Mostrar atributos hijos

tasks.idstring

tasks.titlestring

tasks.startDatestring<date-time> | null

tasks.endDatestring<date-time> | null

tasks.isAllDayboolean

tasks.isCompletedboolean

tasks.typestring | null

tasks.projectIdstring | null

tasks.assignedStaffobject[]

Mostrar atributos hijos

tasks.assignedStaff.idstring

Identificador del miembro del personal.

tasks.assignedStaff.fullNamestring

Nombre que se muestra en la agenda.

internalServicesobject[]

Asignaciones no vinculadas a un pedido.

Mostrar atributos hijos

internalServices.idstring

internalServices.titlestring

internalServices.serviceTypestring

internalServices.startDatestring<date-time>

internalServices.endDatestring<date-time>

internalServices.projectNamestring | null

internalServices.qtynumber

internalServices.assignedStaffobject[]

Mostrar atributos hijos

internalServices.assignedStaff.idstring

Identificador del miembro del personal.

internalServices.assignedStaff.fullNamestring

Nombre que se muestra en la agenda.

internalServices.assignedVehicleIdsstring[]

orderServicesobject[]

Servicios de personal y de flota asociados a un pedido.

Mostrar atributos hijos

orderServices.orderIdstring

orderServices.orderNumberstring

orderServices.serviceNamestring

orderServices.serviceTypestring

orderServices.startDatestring<date-time>

orderServices.endDatestring<date-time>

orderServices.contactNamestring | null

orderServices.projectNamestring | null

orderServices.qtynumber

orderServices.assignedCountnumber

orderServices.assignedStaffobject[]

Mostrar atributos hijos

orderServices.assignedStaff.idstring

Identificador del miembro del personal.

orderServices.assignedStaff.fullNamestring

Nombre que se muestra en la agenda.

Un error es un resultado con isError: true y el problema en content[0].text; no hay structuredContent. Consulta Errores.

Prompts de ejemplo

¿Qué hay en el calendario entre el lunes y el viernes?

La misma operación por REST

Esta herramienta ejecuta GET /api/v1/schedule.

Calendario
Obtener la agenda de un rango
Devuelve la agenda consolidada de una ventana: proyectos, pedidos, tareas, servicios internos y servicios de pedido.
Guías
Escrituras seguras
Un asistente que puede escribir también puede escribir lo equivocado. Decide qué herramientas necesitan a una persona, reintenta sin duplicar y sabe qué pone en marcha una escritura.
Guías
Errores
Un error de herramienta es un resultado con isError: true y el problema en el primer bloque de texto. Ramifica por su code.

¿Te ha resultado útil esta página?

Resultado

Argumentos

Resultado

Prompts de ejemplo

La misma operación por REST

Páginas relacionadas

Obtener la agenda de un rango

Escrituras seguras

Errores