DataWorks:DataWorks Agent dengan klien pihak ketiga

Sebelum memulai

• Anda telah membuat ruang kerja dan memilih Use Data Studio (New Version).

• (Opsional. Diperlukan untuk pengguna RAM.) Pengguna RAM untuk pengembangan tugas harus ditambahkan ke ruang kerja dan diberikan peran Development atau Workspace Manager. Peran Workspace Manager memiliki izin yang luas, jadi berikan dengan hati-hati. Untuk detail tentang penambahan anggota, lihat Tambah anggota ruang kerja.

  Jika Anda menggunakan Akun Alibaba Cloud, Anda dapat melewati langkah ini.

• Anda telah membuat instans lingkungan pengembangan pribadi.

  Catatan

  Jika lingkungan pengembangan pribadi Anda terikat ke Virtual Private Cloud (VPC), Anda harus mengonfigurasi akses internet untuk lingkungan pengembangan pribadi.

Langkah 1: Masuk ke lingkungan pengembangan pribadi

Ikuti langkah-langkah berikut untuk mengaktifkan dan masuk ke lingkungan pengembangan pribadi Anda.

1. Buka halaman Workspaces di Konsol DataWorks. Di bilah navigasi atas, pilih wilayah yang diinginkan. Temukan ruang kerja yang diinginkan dan pilih Shortcuts > Data Studio di kolom Actions.

2. Klik ikon di sebelah Personal Development Environment di bilah navigasi atas untuk memeriksa status instans lingkungan pengembangan pribadi Anda dan masuk ke dalamnya.

   • Jika status instans adalah Running: Klik instans lingkungan pengembangan pribadi yang sedang berjalan di bawah Personal Development Environment untuk masuk.

   • Jika instans berada dalam status lainnya: Klik Management Environment di jendela pop-up. Di halaman Personal Development Environment Instances, temukan instans yang telah Anda buat, klik Start di kolom Actions, dan tunggu hingga Instance Status berubah menjadi Running. Kemudian, klik instans tersebut untuk masuk ke lingkungan pengembangan pribadi.

   Catatan

   Ketika ikon yang mirip dengan muncul di area Personal Development Environment, artinya Anda telah masuk ke lingkungan pengembangan pribadi.

Langkah 2: Instal Cline

Setelah masuk ke lingkungan pengembangan pribadi, ikuti langkah-langkah berikut untuk mengonfigurasi DataWorks Agent. Dokumen ini menggunakan Cline sebagai contoh.

wget https://nodejs.org/dist/v20.19.0/node-v20.19.0-linux-x64.tar.xz
tar xf node-v20.19.0-linux-x64.tar.xz
mv /etc/dsw/node /etc/dsw/node14
mv node-v20.19.0-linux-x64 /etc/dsw/node

bash <(curl -s https://dataworks-notebook-${REGION}.oss-${REGION}.aliyuncs.com/public-datasets/aone-release/dwcode-server/scripts/update.sh)  0.2.169

Langkah 3: Konfigurasi kunci API LLM

Setelah menginstal ekstensi Cline, ikuti langkah-langkah berikut untuk mengonfigurasi kunci API Anda. Contoh ini menunjukkan cara menghubungkan ke API Alibaba Cloud Model Studio (Bailian) menggunakan mode OpenAI Compatible.

1. Di halaman lingkungan pengembangan pribadi Data Studio, klik di pojok kanan atas bilah navigasi atas untuk membuka Copilot Chat, lalu klik untuk beralih ke Cline.

2. Di halaman Cline, klik Use your own API key dan konfigurasikan parameter seperti yang dijelaskan dalam tabel berikut.

   Parameter	Deskripsi
   API Provider	Menentukan penyedia layanan API. Pilih OpenAI Compatible. Ini menunjukkan bahwa Anda akan menggunakan antarmuka yang kompatibel dengan OpenAI untuk menghubungkan ke API Alibaba Cloud Model Studio (Bailian).
   Base URL	URL dasar layanan API, yang menentukan alamat root untuk permintaan API. Sebagai contoh, alamat titik akhir API kompatibel OpenAI yang disediakan oleh API Alibaba Cloud Model Studio (Bailian) adalah https://dashscope-intl.aliyuncs.com/compatible-mode/v1.
   API key	Kunci yang digunakan untuk otentikasi. Anda dapat memperoleh kunci API ini dari Konsol Alibaba Cloud Model Studio (Bailian).
   Model ID	Menentukan model yang ingin Anda gunakan. Model yang berbeda memiliki fungsi dan karakteristik performa yang berbeda. Pilih qwen-coder-plus atau qwen-plus: qwen-coder-plus: Cocok untuk generasi kode dan tugas pemrograman. qwen-plus: Cocok untuk generasi teks umum dan tugas pemrosesan.

3. Klik tombol Let's go! di bawah untuk menyelesaikan konfigurasi kunci API.

Langkah 4: Konfigurasi MCP Server

Setelah mengonfigurasi kunci API, ikuti langkah-langkah berikut untuk menghubungkan dan mengonfigurasi DataWorks MCP Server. Untuk informasi selengkapnya tentang DataWorks MCP Server, lihat Lampiran: DataWorks MCP Server.

1. Di halaman Cline, klik ikon di pojok kanan atas untuk membuka tab Marketplace dari MCP Server.

2. Beralih ke tab Installed untuk melihat server MCP yang telah diinstal.

3. Klik Configure MCP Servers untuk membuka file konfigurasi cline_mcp_settings.json. DataWorks menyediakan konfigurasi default untuk alibabacloud-dataworks-mcp-server. Konfigurasinya sebagai berikut:

   {
     "mcpServers": {
       "alibabacloud-dataworks-mcp-server": {
         "command": "npx",
         "args": [
           "alibabacloud-dataworks-mcp-server"
         ],
         "env": {
           "REGION": "cn-shanghai",
           "ALIBABA_CLOUD_CREDENTIALS_URI": "http://localhost:7002/api/v1/credentials/0",
           "TOOL_CATEGORIES": "SERVER_IDE_DEFAULT"
         },
         "disabled": false,
         "autoApprove": [],
         "timeout": 60
       }
     }
   }

   Parameter		Deskripsi
   command		npx, yang menunjukkan metode perintah yang disediakan oleh dataworks-mcp-server.
   args		alibabacloud-dataworks-mcp-server, yang menunjukkan argumen perintah untuk dataworks-mcp-server.
   env	REGION	Wilayah tempat ruang kerja DataWorks saat ini berada. Contoh menggunakan cn-shanghai.
   	ALIBABA_CLOUD_CREDENTIALS_URI	Menentukan URI untuk kredensial Alibaba Cloud. Penting Parameter ini hanya berlaku di lingkungan pengembangan pribadi DataWorks dan digunakan untuk mendapatkan otentikasi pengguna Alibaba Cloud.
   	TOOL_CATEGORIES	Mengonfigurasi daftar izin kategori Tool. Masukkan kategori OpenAPI di sini, dipisahkan dengan koma. Contoh: "TOOL_CATEGORIES":"Data Sources,Workspace Management,Resource Group Management,Data Map,Data Integration,Data Studio (New Version),Task O&M,Data Service,Open Platform,Data Quality,Tag Management,Security Center,SERVER_IDE_DEFAULT". Catatan SERVER_IDE_DEFAULT mengacu pada Tools default di lingkungan pengembangan pribadi. Kategori layanan lainnya dapat ditemukan di pohon direktori sisi kiri pada halaman DataWorks - Ikhtisar OpenAPI. Untuk meningkatkan performa pemuatan model dan pengalaman pengguna, TOOL_CATEGORIES diatur ke SERVER_IDE_DEFAULT dalam konfigurasi default. Untuk mengaktifkan semua tool OpenAPI, Anda dapat menghapus item konfigurasi ini.
   	TOOL_NAMES	Mengonfigurasi daftar izin nama Tool. Masukkan nama OpenAPI di sini, dipisahkan dengan koma. Contoh: "TOOL_NAMES":"ListProjects,CreateNode,UpdateNode". Catatan Anda dapat menemukan TOOL_NAMES di halaman DataWorks - Ikhtisar OpenAPI.

4. Setelah Anda menyimpan konfigurasi, ketika daftar Tools yang tersedia dimuat, ini mengonfirmasi bahwa alibabacloud-dataworks-mcp-server telah diinstal dan dikonfigurasi. Anda sekarang dapat mulai menggunakan fitur DataWorks MCP Server.

   Catatan

   Jika informasi gagal dimuat, pastikan apakah Anda telah meningkatkan program engine.

   

5. Anda dapat memperluas kemampuan DataWorks Agent dengan langsung mengedit file konfigurasi cline_mcp_settings.json atau dengan menginstal server MCP lain dari Marketplace. Sebagai contoh, untuk menggunakan fitur terkait Hologres di DataWorks Agent, Anda dapat menghubungkan ke Hologres MCP Server.