:DataWorks Agent para clientes de terceiros

Pré-requisitos

• Você created a workspace e selecionou Use Data Studio (New Version).

• (Opcional, para usuários RAM) Adicione o usuário RAM para desenvolvimento de tarefas ao workspace com a função Development ou Workspace Administrator. A função Workspace Manager possui permissões amplas; portanto, atribua-a com cautela. Para detalhes sobre como adicionar membros, consulte Add members to a workspace.

  Se estiver usando uma conta Alibaba Cloud, pule esta etapa.

• Você created a personal development environment instance.

  Nota

  Se seu ambiente de desenvolvimento pessoal precisar estar vinculado a uma VPC, você deve configure public network access for the personal development environment.

Etapa 1: Acessar o ambiente de desenvolvimento pessoal

Siga estas etapas para iniciar e acessar seu ambiente de desenvolvimento pessoal.

1. Acesse a página Workspaces no console do DataWorks. Na barra de navegação superior, selecione a região desejada. Localize o workspace desejado e escolha Shortcuts > Data Studio na coluna Actions.

2. Clique em ao lado de Personal Development Environment na barra de navegação superior para verificar o status da instância do seu ambiente de desenvolvimento pessoal e acessá-lo.

   • Se o Instance Status for Running: Clique em Personal Development Environment para entrar no ambiente.

   • Se a instância tiver qualquer outro status: Clique em Management Environment na janela pop-up. Na página Personal Development Environment Instances, localize sua instância e clique em Start na coluna Actions. Aguarde até que o Instance Status mude para Running e, em seguida, clique em Personal Development Environment para entrar no ambiente.

   Nota

   Um ícone semelhante a na área Personal Development Environment indica que você entrou com sucesso no ambiente de desenvolvimento pessoal.

Etapa 2: Instalar o Cline

Após entrar no ambiente de desenvolvimento pessoal, siga estas etapas para configurar o DataWorks Agent. Este guia usa o Cline como exemplo.

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

Etapa 3: Configurar a chave de API do LLM

Após instalar a extensão Cline, siga estas etapas para configurar sua API Key. Este exemplo mostra como se conectar à API do Model Studio usando o modo OpenAI Compatible.

1. Na página do ambiente de desenvolvimento pessoal do Data Studio, clique em no canto superior direito da barra de navegação superior para abrir o Copilot Chat e, em seguida, clique em para alternar para o Cline.

2. Na página do Cline, clique em Use your own API key e configure os parâmetros conforme descrito na tabela a seguir.

   Parâmetro	Descrição
   API Provider	O provedor de service de API que você deseja usar. Selecione OpenAI Compatible. Isso indica que você usará uma interface compatível com OpenAI para se conectar à API do Model Studio.
   Base URL	A URL base do service de API. Por exemplo, o endpoint de API compatível com OpenAI fornecido pelo Model Studio é https://dashscope-intl.aliyuncs.com/compatible-mode/v1.
   API Key	A chave usada para autenticação. Você pode obter esta API Key no console do Alibaba Cloud Model Studio.
   Model ID	O modelo específico que você deseja usar. Diferentes modelos possuem funções e desempenhos distintos. Selecione qwen-coder-plus ou qwen-plus: qwen-coder-plus: adequado para geração de código e tarefas de programação. qwen-plus: adequado para tarefas gerais de geração e processamento de texto.

3. Clique em Let's go! para salvar a configuração.

Etapa 4: Configurar o MCP Server

Após configurar a API Key, siga estas etapas para se conectar e configurar o DataWorks MCP Server. Para mais informações sobre o DataWorks MCP Server, consulte Appendix: DataWorks MCP Server.

1. No canto superior direito da página do Cline, clique em para acessar a aba MCP Servers Marketplace.

2. Alterne para a aba Installed para visualizar os MCP servers instalados.

3. Clique em Configure MCP Servers para abrir o arquivo de configuração cline_mcp_settings.json. O DataWorks fornece uma configuração padrão para alibabacloud-dataworks-mcp-server. A configuração é a seguinte:

   {
     "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		Descrição
   command		npx, o comando fornecido pelo dataworks-mcp-server.
   args		alibabacloud-dataworks-mcp-server, o argumento de comando para o dataworks-mcp-server.
   env	REGION	A região onde seu workspace do DataWorks está localizado, por exemplo, cn-shanghai.
   	ALIBABA_CLOUD_CREDENTIALS_URI	A URI para a credencial da Alibaba Cloud. Importante Este parâmetro é válido apenas no ambiente de desenvolvimento pessoal do DataWorks e serve para obter a autenticação de usuário da Alibaba Cloud.
   	TOOL_CATEGORIES	Uma lista de permissões de categorias de Tool. Insira as categorias da OpenAPI separadas por vírgulas. Exemplo: "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 refere-se às Tools padrão no ambiente de desenvolvimento pessoal. As outras categorias de service podem ser encontradas na árvore de diretórios à esquerda na página DataWorks - OpenAPI Overview. Para melhorar o desempenho de carregamento do modelo e a experiência do usuário, a configuração padrão define TOOL_CATEGORIES como SERVER_IDE_DEFAULT. Para habilitar todas as ferramentas da OpenAPI, remova este item de configuração.
   	TOOL_NAMES	Uma lista de permissões de nomes de Tool. Insira os nomes da OpenAPI separados por vírgulas. Exemplo: "TOOL_NAMES":"ListProjects,CreateNode,UpdateNode". Nota Você pode encontrar TOOL_NAMES na página DataWorks - OpenAPI Overview.

4. Se uma lista de Tools disponíveis for carregada na página após salvar a configuração, o alibabacloud-dataworks-mcp-server estará instalado e configurado corretamente. Agora você pode usar os recursos do DataWorks MCP Server.

   Nota

   Se essas informações não forem carregadas, certifique-se de ter upgraded the engine.

5. Estenda os recursos do DataWorks Agent editando diretamente o arquivo de configuração cline_mcp_settings.json ou instalando outros MCP servers no Marketplace. Por exemplo, para usar funções relacionadas ao Hologres no DataWorks Agent, conecte-se ao Hologres MCP Server.