Caderninho / guias
Assistentes e ferramentasFerramentas MCPMetas e contribuições

complete_goal

Concluir meta manualmente.

Metas e contribuições · Editar ou configurar · Escrita local

Efeito da chamada

Esta ferramenta altera dados locais da instalação. Confirme a ação e o espaço com o proprietário antes de enviar confirmed: true e uma chave de idempotência. Ela não altera registros nem executa pagamentos no banco.

Parâmetros

CampoObrigatórioTipoUso
confirmedSimtrueDeve ser true somente depois da confirmação explícita do proprietário.
idempotency_keySimtextoChave única para esta solicitação. Reutilize apenas para repetir exatamente a mesma operação.
spaceIdSimtextoEspaço da instalação. Consulte get_spaces; o espaço inicial é personal.
idSimtextoID do registro devolvido por get_goals.

Filtros compostos e limites estão no schema completo. Campos não listados são recusados.

Exemplo de chamada

Substitua os IDs fictícios pelos da sua instalação, obtidos nas consultas indicadas nos parâmetros.


{
  "name": "complete_goal",
  "arguments": {
    "confirmed": true,
    "idempotency_key": "docs:complete_goal:01",
    "spaceId": "personal",
    "id": "id-exemplo"
  }
}

Interpretar o resultado

Confira o resultado da chamada antes de dar a alteração como concluída. Se a rede falhar, repita somente os mesmos argumentos com a mesma chave. Atualize a leitura se a revisão estiver obsoleta antes de confirmar outra operação.

O registro desta ferramenta não declara outputSchema. Consulte as regras de resposta no guia de contratos.

Contrato completo

Ver JSON Schema de entrada

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "confirmed": {
      "type": "boolean",
      "const": true
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160
    },
    "spaceId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160
    },
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160
    }
  },
  "required": [
    "confirmed",
    "idempotency_key",
    "spaceId",
    "id"
  ],
  "additionalProperties": false
}

Voltar para Metas e contribuições · Confirmações e contratos

Nesta página