Planificador

Asignar un recurso a un servicio

Asigna a una persona o a un vehículo a un servicio.

Herramienta

filmo_planner_assignment_create

Escrituraplanner:write

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_planner_assignment_create",
    "arguments": {}
  }
}

{
  "structuredContent": {
    "data": {
      "status": "<status>",
      "conflictCount": 1
    },
    "meta": {
      "idempotencyKey": "<the key you sent, or the one the server generated>",
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}

generado desde el esquema

El destino es EXACTAMENTE uno: el par orderId + orderServiceId, una tarea o un servicio interno. El recurso, también exactamente uno. conflictCount indica con cuántos compromisos del recurso se solapa esta asignación: la asignación se hace igualmente, y tú decides qué hacer con el número. Responde 400 validation_error, con errors[].path en el campo, cuando staffId, vehicleId o el destino (orderServiceId, taskId, internalServiceId) no existe o pertenece a otra cuenta, cuando el destino no acepta ese tipo de recurso (una tarea solo acepta personal; un servicio, los tipos de recurso que declaran sus requisitos) y cuando la tarea no bloquea la disponibilidad; 409 conflict cuando el recurso ya está asignado a ese destino o no está disponible en ese periodo. En ninguno de esos casos se escribe nada.

Argumentos

orderIdstring

Pedido al que está asociado el servicio.

orderServiceIdstring

Línea de servicio dentro de ese pedido. Va con orderId.

taskIdstring

Tarea del planificador a la que asignar el recurso.

internalServiceIdstring

Asignación interna que se va a cubrir.

staffIdstring

Miembro del personal que se asigna.

vehicleIdstring

Vehículo que se asigna.

rolestring

Rol con el que se asigna. P. ej.: "Conductor".

idempotencyKeystring

Clave de idempotencia elegida por el cliente (se recomienda un UUID). Repetir la misma clave con los mismos argumentos en 24 h devuelve la respuesta almacenada sin volver a ejecutar; con argumentos distintos responde 422. Es la forma segura de reintentar tras un fallo de red.

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

Resultado

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

Ver los atributos de data

statusstring

Resultado de la operación.

conflictCountnumber

Compromisos del recurso que se solapan con esta asignación.

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

La misma operación por REST

Esta herramienta ejecuta POST /api/v1/planner/assignments.

Planificador
Asignar un recurso a un servicio
Asigna a una persona o a un vehículo a un servicio.
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

La misma operación por REST

Páginas relacionadas

Asignar un recurso a un servicio

Escrituras seguras

Errores