:DataWorks Agent for third-party clients

Ön Koşullar

• Bir çalışma alanı oluşturdu ve Use Data Studio (New Version) seçeneğini belirlediniz.

• (İsteğe bağlı, RAM kullanıcıları için) Görev geliştirmesi için kullanılan RAM kullanıcısını çalışma alanına Development veya Workspace Administrator rolüyle eklediniz. Çalışma Alanı Yöneticisi rolü geniş izinlere sahiptir, bu nedenle atarken dikkatli olun. Üye ekleme hakkında ayrıntılı bilgi için bkz. Çalışma alanına üye ekleme.

  Alibaba Cloud hesabı kullanıyorsanız bu adımı atlayabilirsiniz.

• Bir kişisel geliştirme ortamı örneği oluşturdunuz.

  Not

  Kişisel geliştirme ortamınızın bir VPC'ye bağlanması gerekiyorsa kişisel geliştirme ortamı için genel ağ erişimini yapılandırmanız gerekir.

Adım 1: Kişisel geliştirme ortamına girin

Kişisel geliştirme ortamınızı başlatmak ve erişmek için şu adımları izleyin.

1. DataWorks konsolundaki Çalışma Alanları sayfasına gidin. Üst gezinme çubuğunda istediğiniz bölgeyi seçin. İstediğiniz çalışma alanını bulun ve Actions sütununda Shortcuts > Data Studio seçeneğini belirleyin.

2. Kişisel geliştirme ortamı örneğinizin durumunu kontrol etmek ve ortama erişmek için üst gezinme çubuğundaki Personal Development Environment yanındaki simgesine tıklayın.

   • Örnek Durumu Running ise: Personal Development Environment altındaki çalışan kişisel geliştirme ortamı örneğine tıklayarak ortama girin.

   • Örneğin başka bir durumu varsa: Açılan pencerede Management Environment seçeneğine tıklayın. Personal Development Environment Instances sayfasında örneğinizi bulun ve Actions sütunundaki Start seçeneğine tıklayın. Instance Status öğesinin Running durumuna geçmesini bekleyin, ardından ortama girmek için örneğe tıklayın.

   Not

   Personal Development Environment alanındaki benzeri bir simge, kişisel geliştirme ortamına başarıyla girdiğinizi gösterir.

Adım 2: Cline'ı yükleyin

Kişisel geliştirme ortamına girdikten sonra DataWorks Agent'ı yapılandırmak için şu adımları izleyin. Bu kılavuzda örnek olarak Cline kullanılmaktadır.

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

Adım 3: LLM API anahtarını yapılandırın

Cline uzantısını yükledikten sonra API Anahtarınızı yapılandırmak için şu adımları izleyin. Bu örnekte, OpenAI Uyumlu modunu kullanarak Model Studio API'ye nasıl bağlanılacağı gösterilmektedir.

1. Data Studio kişisel geliştirme ortamı sayfasında, Copilot Chat'i açmak için üst gezinme çubuğunun sağ üst köşesindeki simgesine tıklayın ve ardından Cline'a geçmek için simgesine tıklayın.

2. Cline sayfasında Kendi API anahtarınızı kullanın seçeneğine tıklayın ve parametreleri aşağıdaki tabloda açıklandığı gibi yapılandırın.

   Parametre	Açıklama
   API Sağlayıcısı	Kullanmak istediğiniz API hizmet sağlayıcısı. OpenAI Compatible seçeneğini belirleyin. Bu, Model Studio API'ye bağlanmak için OpenAI uyumlu bir arayüz kullanacağınız anlamına gelir.
   Temel URL	API hizmetinin temel URL'si. Örneğin, Model Studio tarafından sağlanan OpenAI uyumlu API uç noktası şudur: https://dashscope-intl.aliyuncs.com/compatible-mode/v1.
   API Anahtarı	Kimlik doğrulama için kullanılan anahtar. Bu API Anahtarını Alibaba Cloud Model Studio konsolundan alabilirsiniz.
   Model Kimliği	Kullanmak istediğiniz belirli model. Farklı modeller farklı işlevlere ve performansa sahiptir. qwen-coder-plus veya qwen-plus seçin: qwen-coder-plus: kod oluşturma ve programlama görevleri için uygundur. qwen-plus: genel metin oluşturma ve işleme görevleri için uygundur.

3. Yapılandırmayı kaydetmek için Haydi başlayalım! seçeneğine tıklayın.

Adım 4: MCP Server'ı yapılandırın

API Anahtarını yapılandırdıktan sonra DataWorks MCP Server'a bağlanmak ve bunu yapılandırmak için şu adımları izleyin. DataWorks MCP Server hakkında daha fazla bilgi için bkz. Ek: DataWorks MCP Server.

1. Cline sayfasının sağ üst köşesindeki simgesine tıklayarak MCP Sunucuları Pazar Yeri sekmesine gidin.

2. Yüklenen MCP sunucularını görüntülemek için Yüklendi sekmesine geçin.

3. cline_mcp_settings.json yapılandırma dosyasını açmak için MCP Sunucularını Yapılandır seçeneğine tıklayın. DataWorks, alibabacloud-dataworks-mcp-server için varsayılan bir yapılandırma sağlar. Yapılandırma aşağıdaki gibidir:

   {
     "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
       }
     }
   }

   Parametre		Açıklama
   command		npx, dataworks-mcp-server tarafından sağlanan komut.
   args		alibabacloud-dataworks-mcp-server, dataworks-mcp-server için komut bağımsız değişkeni.
   env	REGION	DataWorks çalışma alanınızın bulunduğu bölge, örneğin cn-shanghai.
   	ALIBABA_CLOUD_CREDENTIALS_URI	Alibaba Cloud kimlik bilgisi için URI. Önemli Bu parametre yalnızca DataWorks kişisel geliştirme ortamında geçerlidir ve Alibaba Cloud kullanıcı kimlik doğrulamasını almak için kullanılır.
   	TOOL_CATEGORIES	Tool kategorilerinin izin listesi. OpenAPI kategorilerini virgülle ayırarak girin. Örnek: "TOOL_CATEGORIES":"Veri Kaynağı,Çalışma Alanı Yönetimi,Kaynak Grubu Yönetimi,Veri Haritası,Veri Entegrasyonu,Data Studio (yeni sürüm),İşletim Merkezi,DataService,Açık Platform,Veri Kalitesi,Etiket Yönetimi,Güvenlik Merkezi,SERVER_IDE_DEFAULT". Not SERVER_IDE_DEFAULT, kişisel geliştirme ortamındaki varsayılan Tools anlamına gelir. Diğer hizmet kategorilerini DataWorks - OpenAPI Genel Bakış sayfasındaki sol taraftaki dizin ağacında bulabilirsiniz. Model yükleme performansını ve kullanıcı deneyimini iyileştirmek için varsayılan yapılandırma TOOL_CATEGORIES değerini SERVER_IDE_DEFAULT olarak ayarlar. Tüm OpenAPI araçlarını etkinleştirmek için bu yapılandırma öğesini kaldırabilirsiniz.
   	TOOL_NAMES	Tool adlarının izin listesi. OpenAPI adlarını virgülle ayırarak girin. Örnek: "TOOL_NAMES":"ListProjects,CreateNode,UpdateNode". Not TOOL_NAMES değerlerini DataWorks - OpenAPI Genel Bakış sayfasında bulabilirsiniz.

4. Yapılandırmayı kaydettikten sonra sayfada kullanılabilir Araçlar listesi yüklenirse alibabacloud-dataworks-mcp-server doğru şekilde yüklenmiş ve yapılandırılmış demektir. Artık DataWorks MCP Server özelliklerini kullanabilirsiniz.

   Not

   Bu bilgiler yüklenemezse altyapıyı yükselttiğinizden emin olun.

5. cline_mcp_settings.json yapılandırma dosyasını doğrudan düzenleyerek veya Pazar Yerinden diğer MCP sunucularını yükleyerek DataWorks Agent'ın yeteneklerini genişletebilirsiniz. Örneğin, DataWorks Agent'ta Hologres ile ilgili işlevleri kullanmak için Hologres MCP Server bağlantısını yapabilirsiniz.