MCP Tools Reference: dataform.googleapis.com

Tool: remove_file

Löschen Sie eine Datei in einem Dataform-Arbeitsbereich.

Das Löschen wird erst übernommen, wenn das commit_workspace_changes-Tool aufgerufen wird.

Der Parameterwert workspace muss das Format projects/{project_id}/locations/{location}/repositories/{repository}/workspaces/{workspace} haben.

Der Parameterwert path ist der relative Pfad zur Datei vom Arbeitsbereichsstamm aus. Verwenden Sie keine Pfadmanipulation wie ... Gültige Dateipfade können mit den Tools query_directory_contents oder search_files abgerufen werden.

Das folgende Codebeispiel zeigt, wie Sie mit curl das MCP-Tool remove_file aufrufen.

Curl-Anfrage
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
}'

Eingabeschema

RemoveFile-Anfragenachricht.

RemoveFileRequest

JSON-Darstellung
{
  "workspace": string,
  "path": string
}
Felder
workspace

string

Erforderlich. Der Name des Arbeitsbereichs.

path

string

Erforderlich. Der vollständige Pfad der Datei, einschließlich des Dateinamens, relativ zum Arbeitsbereichstammverzeichnis.

Ausgabeschema

RemoveFile-Antwortnachricht.

Tool-Annotationen

Tool-Anmerkungen werden an MCP-Clients gesendet, um das grundlegende Risiko eines bestimmten Tools zu beschreiben. Die meisten Clients behandeln diese Hinweise als nicht vertrauenswürdig, sie können aber verwendet werden, um zu entscheiden, wann eine Bestätigungsaufforderung an einen Nutzer gesendet wird.

Zusammen mit dem Titelstring sind die folgenden booleschen Hinweise definiert:

  • readOnlyHint: Wenn „true“, ändert das Tool seine Umgebung nicht. Standardeinstellung: false.
  • destructiveHint: Wenn „true“, kann das Tool destruktive Aktionen ausführen. Wenn „false“, kann das Tool nur additive Aktionen ausführen. Standardeinstellung: true.
  • idempotentHint: Wenn „true“, hat das wiederholte Aufrufen des Tools mit denselben Argumenten keine zusätzlichen Auswirkungen auf die Umgebung. Standardeinstellung: false.
  • openWorldHint: Wenn „true“, kann das Tool mit einer „offenen Welt“ externer Einheiten interagieren. Wenn „false“, kann das Tool nur mit internen Einheiten interagieren. Ein Web-Suchtool wäre beispielsweise frei verfügbar, ein Tool für das Gedächtnis jedoch nicht.

Destruktiver Hinweis: ✅ | Idempotenter Hinweis: ✅ | Nur-Lese-Hinweis: ❌ | Open-World-Hinweis: ❌