:DataWorks Agent for third-party clients

Requisitos previos

• Ha created a workspace y ha seleccionado Use Data Studio (New Version).

• (Opcional, para usuarios RAM) Ha agregado el usuario RAM para desarrollo de tareas al espacio de trabajo con el rol Development o Workspace Administrator. El rol Workspace Manager tiene permisos amplios, así que asígnelo con precaución. Para obtener detalles sobre cómo agregar miembros, consulte Add members to a workspace.

  Si utiliza una cuenta de Alibaba Cloud, puede omitir este paso.

• Ha created a personal development environment instance.

  Nota

  Si su entorno de desarrollo personal necesita vincularse a una VPC, debe configure public network access for the personal development environment.

Paso 1: Ingresar al entorno de desarrollo personal

Siga estos pasos para iniciar y acceder a su entorno de desarrollo personal.

1. Vaya a la página Workspaces en la consola de DataWorks. En la barra de navegación superior, seleccione la región deseada. Busque el espacio de trabajo deseado y elija Shortcuts > Data Studio en la columna Actions.

2. Haga clic en el icono junto a Personal Development Environment en la barra de navegación superior para comprobar el estado de su instancia de entorno de desarrollo personal y acceder a ella.

   • Si el Instance Status es Running: Haga clic en la instancia de entorno de desarrollo personal en ejecución bajo Personal Development Environment para ingresar al entorno.

   • Si la instancia tiene cualquier otro estado: Haga clic en Management Environment en la ventana emergente. En la página Personal Development Environment Instances, busque su instancia y haga clic en Start en la columna Actions. Espere a que el Instance Status cambie a Running y luego haga clic en la instancia para ingresar al entorno.

   Nota

   Un icono similar a en el área de Personal Development Environment indica que ha ingresado correctamente al entorno de desarrollo personal.

Paso 2: Instalar Cline

Después de ingresar al entorno de desarrollo personal, siga estos pasos para configurar DataWorks Agent. Esta guía utiliza Cline como ejemplo.

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

Paso 3: Configurar la clave de API del LLM

Después de instalar la extensión Cline, siga estos pasos para configurar su API Key. Este ejemplo muestra cómo conectarse a la API de Model Studio mediante el modo OpenAI Compatible.

1. On the Data Studio personal development environment page, click the en la esquina superior derecha de la barra de navegación superior para abrir Copilot Chat y luego haga clic en el icono para cambiar a Cline.

2. En la página de Cline, haga clic en Use your own API key y configure los parámetros como se describe en la siguiente tabla.

   Parámetro	Descripción
   API Provider	El proveedor de servicios de API que desea utilizar. Seleccione OpenAI Compatible. Esto indica que utilizará una interfaz compatible con OpenAI para conectarse a la API de Model Studio.
   Base URL	La URL base del servicio de API. Por ejemplo, el endpoint de API compatible con OpenAI proporcionado por Model Studio es https://dashscope-intl.aliyuncs.com/compatible-mode/v1.
   API Key	La clave que se utiliza para la autenticación. Puede obtener esta API Key desde la consola de Alibaba Cloud Model Studio.
   Model ID	El modelo específico que desea utilizar. Los diferentes modelos tienen distintas funciones y rendimiento. Seleccione qwen-coder-plus o qwen-plus: qwen-coder-plus: adecuado para generación de código y tareas de programación. qwen-plus: adecuado para tareas generales de generación y procesamiento de texto.

3. Haga clic en Let's go! para guardar la configuración.

Paso 4: Configurar el MCP Server

Después de configurar la API Key, siga estos pasos para conectarse y configurar el DataWorks MCP Server. Para más información sobre el DataWorks MCP Server, consulte Appendix: DataWorks MCP Server.

1. En la esquina superior derecha de la página de Cline, haga clic en el icono para ir a la pestaña MCP Servers Marketplace.

2. Cambie a la pestaña Installed para ver los servidores MCP instalados.

3. Haga clic en Configure MCP Servers para abrir el archivo de configuración cline_mcp_settings.json. DataWorks proporciona una configuración predeterminada para alibabacloud-dataworks-mcp-server. La configuración es la siguiente:

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

   Parámetro		Descripción
   command		npx, el comando proporcionado por dataworks-mcp-server.
   args		alibabacloud-dataworks-mcp-server, el argumento de comando para dataworks-mcp-server.
   env	REGION	La región donde se encuentra su espacio de trabajo de DataWorks, por ejemplo, cn-shanghai.
   	ALIBABA_CLOUD_CREDENTIALS_URI	La URI para la credencial de Alibaba Cloud. Importante Este parámetro solo es válido en el entorno de desarrollo personal de DataWorks y se utiliza para obtener la autenticación de usuario de Alibaba Cloud.
   	TOOL_CATEGORIES	Una lista de permitidos de categorías de Tool. Introduzca las categorías de OpenAPI separadas por comas. Ejemplo: "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". Nota SERVER_IDE_DEFAULT hace referencia a las Tools predeterminadas en el entorno de desarrollo personal. Las demás categorías de servicios se encuentran en el árbol de directorios izquierdo de la página DataWorks - OpenAPI Overview. Para mejorar el rendimiento de carga del modelo y la experiencia del usuario, la configuración predeterminada establece TOOL_CATEGORIES en SERVER_IDE_DEFAULT. Para habilitar todas las herramientas de OpenAPI, puede eliminar este elemento de configuración.
   	TOOL_NAMES	Una lista de permitidos de nombres de Tool. Introduzca los nombres de OpenAPI separados por comas. Ejemplo: "TOOL_NAMES":"ListProjects,CreateNode,UpdateNode". Nota Puede encontrar TOOL_NAMES en la página DataWorks - OpenAPI Overview.

4. Si se carga una lista de Tools disponibles en la página después de guardar la configuración, alibabacloud-dataworks-mcp-server se instaló y configuró correctamente. Ahora puede utilizar las funciones del DataWorks MCP Server.

   Nota

   Si esta información no se carga, asegúrese de haber upgraded the engine.

5. Puede ampliar las capacidades de DataWorks Agent editando directamente el archivo de configuración cline_mcp_settings.json o instalando otros servidores MCP desde el Marketplace. Por ejemplo, para utilizar funciones relacionadas con Hologres en DataWorks Agent, puede conectarse al Hologres MCP Server.