Ir para o conteúdo
Todas as ferramentas

todo_complete_task

Lembretes e Microsoft To Do · macOS · Windows

Efeito: escrita. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Marca uma tarefa do Microsoft To Do como concluída. Funciona pelo Apple Reminders, que sincroniza com o To Do quando a conta da Microsoft é adicionada ao Reminders, então a alteração aparece no To Do após a próxima sincronização. Prefira task_id de todo_list_tasks. Com `title` no lugar, conclui a única tarefa aberta cujo título contém esse texto (sem diferenciar maiúsculas de minúsculas); se várias corresponderem, NÃO conclui NENHUMA e as lista com seu task_id. Sem `list`, pesquisa todas as listas do Reminders, não somente as do To Do. Chamada sem confirm, retorna uma prévia; passe confirm=true para concluir.

Entradas obrigatórias

O esquema desta plataforma não declara entradas obrigatórias. Ainda podem existir seletores opcionais ou requisitos de execução.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Esquema técnico canónico em 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"
}

Exemplo documental

Exemplo de documentação para todo_complete_task. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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

Windows

Finalidade

Marca uma tarefa como concluída no Microsoft To Do/Tarefas do Outlook, pelo app de desktop do Outlook; somente Windows. Sem confirm=true, nada muda: a chamada retorna uma prévia que repete o assunto e a lista e não procura a tarefa, então não diz se a tarefa existe. Com confirm=true, procura a tarefa cujo assunto é igual a `subject` (sem correspondência parcial, sem ID de tarefa) e a define como concluída em 100%. Sem `list`, procura apenas na pasta raiz Tarefas, não em suas subpastas; com `list`, um nome ou caminho completo de todo_list_tasks, procura apenas ali, e uma lista desconhecida ou que corresponda a várias pastas é recusada com um erro. Quando várias tarefas ABERTAS nessa pasta têm o mesmo assunto, nenhuma é concluída: a chamada falha e lista as candidatas, cada uma com um task_id; chame novamente com esse task_id para concluir uma. Uma tarefa inexistente retorna 'not found', e uma resposta do Outlook que não confirma a alteração é um erro, nunca um sucesso. A tarefa não é excluída; este servidor não tem ferramenta para reabri-la.

Entradas obrigatórias

O esquema desta plataforma não declara entradas obrigatórias. Ainda podem existir seletores opcionais ou requisitos de execução.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Esquema técnico canónico em 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"
    },
    "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"
}

Exemplo documental

Exemplo de documentação para todo_complete_task. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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