Vai al contenuto
Tutti gli strumenti

todo_complete_task

Promemoria e Microsoft To Do · macOS · Windows

Effetto: scrittura. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Segna come completata un'attività di Microsoft To Do. Funziona tramite Apple Promemoria, che si sincronizza con To Do quando l'account Microsoft è aggiunto a Promemoria, quindi la modifica compare in To Do dopo la sincronizzazione successiva. Preferisci task_id da todo_list_tasks. Con `title`, invece, completa l'unica attività aperta il cui titolo contiene quel testo (senza distinzione tra maiuscole e minuscole); se più attività corrispondono, non ne completa NESSUNA e le elenca con il loro task_id. Senza `list` cerca in tutte le liste di Promemoria, non solo in quelle di To Do. Se chiamato senza confirm restituisce un'anteprima; passa confirm=true per completare.

Input obbligatori

Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

Esempio di documentazione per todo_complete_task. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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

Windows

Scopo

Segna come completata un'attività in Microsoft To Do / Attività di Outlook, tramite l'app desktop Outlook; solo Windows. Senza confirm=true non cambia nulla: la chiamata restituisce un'anteprima che ripete l'oggetto e la lista e non cerca l'attività, quindi non dice se l'attività esiste. Con confirm=true cerca l'attività il cui oggetto è uguale a `subject` (nessuna corrispondenza parziale, nessun ID attività) e la imposta come completata al 100%. Senza `list` cerca solo nella cartella radice Attività, non nelle sue sottocartelle; con `list`, un nome o un percorso completo da todo_list_tasks, cerca solo lì, e una lista sconosciuta o che corrisponde a più cartelle viene rifiutata con un errore. Quando più attività APERTE in quella cartella hanno lo stesso oggetto, non ne viene completata nessuna: la chiamata fallisce ed elenca le candidate, ciascuna con un task_id; chiama di nuovo con quel task_id per completarne una. Un'attività mancante restituisce 'not found', e una risposta di Outlook che non conferma la modifica è un errore, mai un successo. L'attività non viene eliminata; questo server non ha uno strumento per riaprirla.

Input obbligatori

Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

Schema tecnico canonico in inglese — 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"
    },
    "task_id": {
      "description": "A task_id listed by this tool when several open tasks share the subject. Completes exactly that task; subject and list are not needed.",
      "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"
}

Esempio documentale

Esempio di documentazione per todo_complete_task. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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