Personal

Comprobar la disponibilidad del personal

Devuelve, para cada miembro del personal (todo el equipo, o los seleccionados por staffIds, tags, collectionId o search), si tiene compromisos que se solapan con la ventana consultada y cuáles, tipificados: líneas de pedido, servicios internos, ausencias declaradas e incidencias bloqueantes.

Herramienta

filmo_staff_availability_check

Lecturastaff:read

staff:read
120/min + 30/min de disponibilidad
Anotación del servidor: Solo lectura
Anotación del servidor: Idempotente

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

{
  "structuredContent": {
    "data": [
      {
        "resourceId": "reso_8f2a1c",
        "name": "Example",
        "available": true,
        "commitments": [
          {
            "kind": "order",
            "orderId": "orde_8f2a1c",
            "orderNumber": "<orderNumber>",
            "label": "Example",
            "startDate": "2026-09-01T08:00:00Z",
            "endDate": "2026-09-01T08:00:00Z"
          }
        ]
      }
    ],
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}

generado desde el esquema

A diferencia de /api/v1/availability/check, la respuesta NO es aritmética de stock: una persona no tiene conjunto, o está libre o está en un trabajo concreto. Un identificador solicitado que no existe vuelve como error por elemento. Consulta idempotente (POST por el cuerpo estructurado). Comparte la cuota de disponibilidad de 30 req/min.

Argumentos

startDatestring<date-time>Obligatorio

Inicio de la ventana a comprobar (ISO 8601 con desplazamiento).

endDatestring<date-time>Obligatorio

Fin de la ventana que se comprueba (ISO 8601 con desplazamiento); debe ser posterior a startDate.

tagsstring[]

Solo los recursos que tengan TODOS estos identificadores de etiqueta.

Límites: mín. 1 elementos, máx. 50 elementos, cada uno: longitud mín. 1, cada uno: longitud máx. 100

collectionIdstring

Solo los recursos de esta colección.

Límites: longitud mín. 1, longitud máx. 100

searchstring

Búsqueda de texto libre en el nombre.

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

staffIdsstring[]

Limita la respuesta a estos miembros del personal (1-100). Un identificador que no existe vuelve como error por elemento.

Límites: mín. 1 elementos, máx. 100 elementos, cada uno: longitud mín. 1, cada uno: longitud máx. 100

Resultado

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

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

Prompts de ejemplo

¿Qué miembros del equipo están libres el 20 de enero?

La misma operación por REST

Esta herramienta ejecuta POST /api/v1/staff/availability.

Personal
Comprobar la disponibilidad del personal
Devuelve, para cada miembro del personal (todo el equipo, o los seleccionados por staffIds, tags, collectionId o search), si tiene compromisos que se solapan con la ventana consultada y cuáles, tipificados: líneas de pedido, servicios internos, ausencias declaradas e incidencias bloqueantes.
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

Comprobar la disponibilidad del personal

Escrituras seguras

Errores