:DataWorks Agent com clientes de terceiros

Antes de começar

• Você já criou um workspace e selecionou Use Data Studio (New Version).

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

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

• Você já criou uma instância de ambiente de desenvolvimento pessoal.

  Nota

  Se o seu ambiente de desenvolvimento pessoal estiver vinculado a uma Virtual Private Cloud (VPC), configure o acesso à internet para o ambiente de desenvolvimento pessoal.

Etapa 1: Acessar o ambiente de desenvolvimento pessoal

Siga estas etapas para ativar 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 status da instância for Running: Clique em Personal Development Environment para acessá-la.

   • Se a instância estiver em qualquer outro estado: Clique em Management Environment na janela pop-up. Na página Personal Development Environment Instances, localize a instância criada, clique em Start na coluna Actions e aguarde até que o Instance Status mude para Running. Em seguida, clique em Personal Development Environment para entrar no ambiente de desenvolvimento pessoal.

   Nota

   Quando um ícone semelhante a aparecer na área Personal Development Environment, significa que você entrou 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 documento 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 chave de API do LLM

Após instalar a extensão Cline, siga estas etapas para configurar sua chave de API. 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	Especifica o provedor de serviços de API. 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 serviço de API, que especifica o endereço raiz para solicitações de API. Por exemplo, o endereço de endpoint de API compatível com OpenAI fornecido pela API do Model Studio é https://dashscope-intl.aliyuncs.com/compatible-mode/v1.
   API key	A chave usada para autenticação. Você pode obter essa chave de API no console do Model Studio.
   Model ID	Especifica o modelo que você deseja usar. Diferentes modelos possuem funções e características de desempenho distintas. 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! abaixo para concluir a configuração da chave de API.

Etapa 4: Configurar o MCP Server

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

1. Na página do Cline, clique em no canto superior direito para acessar a aba Marketplace do MCP Server.

2. Alterne para a aba Installed para visualizar os servidores MCP 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, que indica o método de comando fornecido pelo dataworks-mcp-server.
   args		alibabacloud-dataworks-mcp-server, que indica o argumento de comando para o dataworks-mcp-server.
   env	REGION	A região onde o workspace atual do DataWorks está localizado. O exemplo usa cn-shanghai.
   	ALIBABA_CLOUD_CREDENTIALS_URI	Especifica a URI para credenciais da Alibaba Cloud. Importante Este parâmetro é efetivo apenas no ambiente de desenvolvimento pessoal do DataWorks e é usado para obter a autenticação de usuário da Alibaba Cloud.
   	TOOL_CATEGORIES	Configura a lista de permissões de categorias de Tool. Insira aqui as categorias da OpenAPI, separadas por vírgulas. Exemplo: "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". Nota SERVER_IDE_DEFAULT refere-se às Tools padrão no ambiente de desenvolvimento pessoal. As outras categorias de serviço podem ser encontradas na árvore de diretórios à esquerda na página DataWorks - Visão Geral da OpenAPI. Para melhorar o desempenho de carregamento do modelo e a experiência do usuário, TOOL_CATEGORIES está definido como SERVER_IDE_DEFAULT na configuração padrão. Para habilitar todas as ferramentas da OpenAPI, remova este item de configuração.
   	TOOL_NAMES	Configura a lista de permissões de nomes de Tool. Insira aqui os nomes da OpenAPI, separados por vírgulas. Exemplo: "TOOL_NAMES":"ListProjects,CreateNode,UpdateNode". Nota Você pode encontrar os TOOL_NAMES na página DataWorks - Visão Geral da OpenAPI.

4. Após salvar a configuração, quando a lista de Tools disponíveis for carregada, isso confirmará que o alibabacloud-dataworks-mcp-server está instalado e configurado. Agora você pode começar a usar os recursos do DataWorks MCP Server.

   Nota

   Se as informações não forem carregadas, confirme se você atualizou o mecanismo de programa.

   

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