MCP Tools Reference: dataform.googleapis.com

Ferramenta: remove_file

Excluir um arquivo em um espaço de trabalho do Dataform.

A exclusão permanece não confirmada até que a ferramenta commit_workspace_changes seja chamada.

O valor de parâmetro workspace precisa estar no formato projects/{project_id}/locations/{location}/repositories/{repository}/workspaces/{workspace}.

O valor de parâmetro path é o caminho relativo do arquivo na raiz do espaço de trabalho. Não use travessia de diretório, como ... Caminhos de arquivo válidos podem ser obtidos usando as ferramentas query_directory_contents ou search_files.

O exemplo de código a seguir mostra como usar curl para chamar a ferramenta MCP remove_file.

Solicitação curl
curl --location 'https://dataform.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "remove_file",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Mensagem de solicitação RemoveFile.

RemoveFileRequest

Representação JSON
{
  "workspace": string,
  "path": string
}
Campos
workspace

string

Obrigatório. O nome do espaço de trabalho.

path

string

Obrigatório. O caminho completo do arquivo, incluindo o nome do arquivo, relativo à raiz do espaço de trabalho.

Esquema de saída

Mensagem de resposta RemoveFile.

Anotações de ferramentas

As anotações de ferramentas são enviadas aos clientes do MCP para descrever o risco básico de uma determinada ferramenta. A maioria dos clientes trata essas dicas como não confiáveis, mas elas podem ser usadas para decidir quando um pedido de confirmação pode ser enviado a um usuário.

Além da string de título, as seguintes dicas booleanas são definidas da seguinte maneira:

  • readOnlyHint: se for "true", a ferramenta não vai modificar o ambiente. Padrão: false.
  • destructiveHint: se for "true", a ferramenta poderá realizar ações destrutivas. Se for "false", a ferramenta só poderá realizar ações aditivas. Padrão: verdadeiro.
  • idempotentHint: se for "true", chamar a ferramenta repetidamente com os mesmos argumentos não terá efeito adicional no ambiente dela. Padrão: false.
  • openWorldHint: se for "true", a ferramenta poderá interagir com um "mundo aberto" de entidades externas. Se for "false", a ferramenta só poderá interagir com entidades internas. Por exemplo, uma ferramenta de pesquisa na Web seria de mundo aberto, enquanto uma ferramenta de memória não seria.

Dica destrutiva: ✅ | Dica idempotente: ✅ | Dica somente leitura: ❌ | Dica de mundo aberto: ❌