:DataWorks Agent pour les clients tiers

Prérequis

• Vous avez créé un espace de travail et sélectionné Use Data Studio (New Version).

• (Facultatif, pour les utilisateurs RAM) Ajoutez l'utilisateur RAM dédié au développement des tâches à l'espace de travail avec le rôle Development ou Workspace Administrator. Le rôle Workspace Manager dispose d'autorisations étendues ; attribuez-le avec prudence. Pour plus de détails sur l'ajout de membres, consultez la rubrique Ajouter des membres à un espace de travail.

  Si vous utilisez un compte Alibaba Cloud, ignorez cette étape.

• Vous avez créé une instance d'environnement de développement personnel.

  Remarque

  Si votre environnement de développement personnel doit être associé à un VPC, configurez l'accès au réseau public pour l'environnement de développement personnel.

Étape 1 : Accéder à l'environnement de développement personnel

Suivez ces étapes pour démarrer et accéder à votre environnement de développement personnel.

1. Accédez à la page Workspaces de la console DataWorks. Dans la barre de navigation supérieure, sélectionnez la région souhaitée. Localisez l'espace de travail concerné et choisissez Shortcuts > Data Studio dans la colonne Actions.

2. Cliquez sur l'icône située à côté de Personal Development Environment dans la barre de navigation supérieure pour vérifier l'état de votre instance d'environnement de développement personnel et y accéder.

   • Si l'état de l'instance est Running : Cliquez sur l'instance d'environnement de développement personnel en cours d'exécution sous Personal Development Environment pour entrer dans l'environnement.

   • Si l'instance présente un autre état : Cliquez sur Management Environment dans la fenêtre contextuelle. Sur la page Personal Development Environment Instances, localisez votre instance et cliquez sur Start dans la colonne Actions. Attendez que l'Instance Status passe à Running, puis cliquez sur l'instance pour entrer dans l'environnement.

   Remarque

   Une icône similaire à dans la zone Personal Development Environment indique que vous avez bien accédé à l'environnement de développement personnel.

Étape 2 : Installer Cline

Une fois dans l'environnement de développement personnel, suivez ces étapes pour configurer DataWorks Agent. Ce guide utilise Cline à titre d'exemple.

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

Étape 3 : Configurer la clé API du LLM

Après avoir installé l'extension Cline, suivez ces étapes pour configurer votre clé API. Cet exemple illustre la connexion à l'API Model Studio en utilisant le mode OpenAI Compatible.

1. Sur la page de l'environnement de développement personnel de Data Studio, cliquez sur l'icône située dans le coin supérieur droit de la barre de navigation supérieure pour ouvrir Copilot Chat, puis cliquez sur l'icône pour basculer vers Cline.

2. Sur la page Cline, cliquez sur Use your own API key et configurez les paramètres comme décrit dans le tableau suivant.

   Paramètre	Description
   API Provider	Le fournisseur de services API que vous souhaitez utiliser. Sélectionnez OpenAI Compatible. Cela indique que vous utiliserez une interface compatible avec OpenAI pour vous connecter à l'API Model Studio.
   Base URL	L'URL de base du service API. Par exemple, le point de terminaison d'API compatible avec OpenAI fourni par Model Studio est https://dashscope-intl.aliyuncs.com/compatible-mode/v1.
   API Key	La clé utilisée pour l'authentification. Vous pouvez obtenir cette clé API depuis la console Alibaba Cloud Model Studio.
   Model ID	Le modèle spécifique que vous souhaitez utiliser. Différents modèles offrent des fonctionnalités et des performances variées. Sélectionnez qwen-coder-plus ou qwen-plus : qwen-coder-plus : adapté à la génération de code et aux tâches de programmation. qwen-plus : adapté à la génération et au traitement de texte général.

3. Cliquez sur Let's go! pour enregistrer la configuration.

Étape 4 : Configurer le serveur MCP

Après avoir configuré la clé API, suivez ces étapes pour vous connecter au serveur DataWorks MCP et le configurer. Pour plus d'informations sur le serveur DataWorks MCP, consultez l'Annexe : Serveur DataWorks MCP.

1. Dans le coin supérieur droit de la page Cline, cliquez sur l'icône pour accéder à l'onglet MCP Servers Marketplace.

2. Basculez vers l'onglet Installed pour afficher les serveurs MCP installés.

3. Cliquez sur Configure MCP Servers pour ouvrir le fichier de configuration cline_mcp_settings.json. DataWorks fournit une configuration par défaut pour alibabacloud-dataworks-mcp-server. La configuration est la suivante :

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

   Paramètre		Description
   command		npx, la commande fournie par dataworks-mcp-server.
   args		alibabacloud-dataworks-mcp-server, l'argument de commande pour dataworks-mcp-server.
   env	REGION	La région où se trouve votre espace de travail DataWorks, par exemple cn-shanghai.
   	ALIBABA_CLOUD_CREDENTIALS_URI	L'URI des identifiants Alibaba Cloud. Important Ce paramètre n'est valide que dans l'environnement de développement personnel de DataWorks et sert à obtenir l'authentification de l'utilisateur Alibaba Cloud.
   	TOOL_CATEGORIES	Une liste d'autorisation des catégories d'Tool. Saisissez les catégories d'API OpenAPI, séparées par des virgules. Exemple : "TOOL_CATEGORIES":"Data Source,Workspace Management,Resource Group Management,Data Map,Data Integration,Data Studio (new version),Operation Center,DataService,Open Platform,Data Quality,Label Management,Security Center,SERVER_IDE_DEFAULT". Remarque SERVER_IDE_DEFAULT fait référence aux Tools par défaut dans l'environnement de développement personnel. Les autres catégories de service sont disponibles dans l'arborescence de gauche sur la page DataWorks - OpenAPI Overview. Pour améliorer les performances de chargement du modèle et l'expérience utilisateur, la configuration par défaut définit TOOL_CATEGORIES sur SERVER_IDE_DEFAULT. Pour activer tous les outils d'API OpenAPI, supprimez cet élément de configuration.
   	TOOL_NAMES	Une liste d'autorisation des noms d'Tool. Saisissez les noms d'API OpenAPI, séparés par des virgules. Exemple : "TOOL_NAMES":"ListProjects,CreateNode,UpdateNode". Remarque Vous pouvez trouver TOOL_NAMES sur la page DataWorks - OpenAPI Overview.

4. Si une liste des outils disponibles se charge sur la page après avoir enregistré la configuration, cela signifie que alibabacloud-dataworks-mcp-server est correctement installé et configuré. Vous pouvez désormais utiliser les fonctionnalités du serveur DataWorks MCP.

   Remarque

   Si ces informations ne se chargent pas, assurez-vous d'avoir mis à niveau le moteur.

5. Étendez les capacités de DataWorks Agent en modifiant directement le fichier de configuration cline_mcp_settings.json ou en installant d'autres serveurs MCP depuis le Marketplace. Par exemple, pour utiliser les fonctions liées à Hologres dans DataWorks Agent, connectez-vous au serveur Hologres MCP.