Saltar al contenido
Todas las herramientas

todo_complete_task

Recordatorios y Microsoft To Do · macOS · Windows

Efecto: escritura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Marca una tarea de Microsoft To Do como completa. Funciona a través de Apple Reminders, que se sincroniza con To Do cuando la cuenta de Microsoft se agrega a Reminders, por lo que el cambio aparece en To Do tras la siguiente sincronización. Es preferible usar task_id de todo_list_tasks. Si se usa `title` en su lugar, completa la PRIMERA tarea abierta cuyo título contenga ese texto (sin distinguir mayúsculas de minúsculas): si coinciden varias, solo se completa una y nada lo advierte, y sin `list` busca en todas las listas de Reminders, no solo en las de To Do. Si se llama sin confirm, devuelve una vista previa; pase confirm=true para completarla.

Entradas obligatorias

El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Esquema técnico canónico en inglés — macOS
{
  "properties": {
    "confirm": {
      "description": "Must be true to complete",
      "type": "boolean"
    },
    "list": {
      "description": "List name to narrow search by title (optional)",
      "type": "string"
    },
    "task_id": {
      "description": "Task ID from todo_list_tasks",
      "type": "string"
    },
    "title": {
      "description": "Task title (partial match, alternative to task_id)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para todo_complete_task. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{
  "confirm": false,
  "title": "Planning meeting"
}

Windows

Propósito

Marca una tarea como completa en Microsoft To Do/Tareas de Outlook, a través de la aplicación de escritorio de Outlook; solo en Windows. Sin confirm=true no cambia nada: la llamada devuelve una vista previa que repite el asunto y la lista y no busca la tarea, por lo que no indica si la tarea existe. Con confirm=true busca la tarea cuyo asunto es igual a `subject` (sin coincidencia parcial ni ID de tarea) y la marca como completa al 100 %. Sin `list` busca solo en la carpeta raíz Tareas, no en sus subcarpetas; con `list`, un nombre o ruta completa de todo_list_tasks, busca solo allí, y una lista desconocida o que coincide con varias carpetas se rechaza con un error. Cuando varias tareas de esa carpeta comparten el asunto, se completa sin advertencia la primera que devuelve Outlook, y puede ser una que ya estaba completa. Una tarea inexistente devuelve 'not found', y una respuesta de Outlook que no confirma el cambio es un error, nunca un éxito. La tarea no se elimina; este servidor no tiene ninguna herramienta para reabrirla.

Entradas obligatorias

El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Esquema técnico canónico en inglés — Windows
{
  "properties": {
    "confirm": {
      "description": "Must be true to complete",
      "type": "boolean"
    },
    "list": {
      "description": "Task list or folder to complete the task in, by name or full path as reported by todo_list_tasks (default: only the root Tasks folder). Disambiguates when the same subject exists in more than one list. The name the cloud catalog (Mac) advertises.",
      "type": "string"
    },
    "subject": {
      "description": "Task subject (exact match)",
      "type": "string"
    },
    "title": {
      "description": "Alias for `subject` — the name the cloud catalog (Mac) advertises. Exact match here, unlike the Mac tool's partial match.",
      "type": "string"
    }
  },
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para todo_complete_task. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{
  "confirm": false,
  "title": "Planning meeting"
}