MCP Tools Reference: dataform.googleapis.com

Alat: write_file

Menulis konten file di dalam ruang kerja Dataform, membuat file jika tidak ada.

Nilai parameter contents yang diberikan akan menggantikan seluruh file, jadi baca konten saat ini dengan alat read_file sebelum melakukan pengeditan sebagian. Perubahan tetap tidak dilakukan hingga alat commit_workspace_changes dipanggil.

Nilai parameter workspace harus dalam format projects/{project_id}/locations/{location}/repositories/{repository}/workspaces/{workspace}.

Nilai parameter path adalah jalur relatif ke file dari root ruang kerja. Jangan gunakan penelusuran direktori, seperti ...

Nilai parameter contents harus berupa string berenkode base64 yang berisi konten file.

Contoh kode berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP write_file.

Permintaan 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": "write_file",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Skema Input

Pesan permintaan WriteFile.

WriteFileRequest

Representasi JSON 
{
  "workspace": string,
  "path": string,
  "contents": string
}
Kolom
workspace

string

Wajib. Nama ruang kerja.
path

string

Wajib. File.
contents

string (bytes format)

Wajib. Isi file.

String berenkode base64.

Skema Output

Pesan respons WriteFile.

Anotasi Alat

Anotasi alat dikirim ke klien MCP untuk menjelaskan risiko dasar alat tertentu. Sebagian besar klien memperlakukan petunjuk ini sebagai tidak tepercaya, tetapi petunjuk ini dapat digunakan untuk memutuskan kapan perintah konfirmasi dapat dikirim ke pengguna.

Selain string judul, petunjuk boolean berikut ditentukan sebagai berikut:

  • readOnlyHint: Jika benar, alat tidak akan mengubah lingkungannya. Default: false.
  • destructiveHint: Jika benar, alat dapat melakukan tindakan destruktif. Jika salah (false), alat hanya dapat melakukan tindakan tambahan. Default: true.
  • idempotentHint: Jika benar (true), memanggil alat berulang kali dengan argumen yang sama tidak akan memberikan efek tambahan pada lingkungannya. Default: false.
  • openWorldHint: Jika benar, alat dapat berinteraksi dengan 'dunia terbuka' entitas eksternal. Jika salah (false), alat hanya dapat berinteraksi dengan entitas internal. Misalnya, alat penelusuran web akan menjadi open world, sedangkan alat memori tidak akan menjadi open world.

Petunjuk Destruktif: ✅ | Petunjuk Idempoten: ✅ | Petunjuk Hanya Baca: ❌ | Petunjuk Dunia Terbuka: ❌