Com a conectividade de rede estabelecida, é possível usar um modelo implantado em qualquer workspace do DataWorks na mesma região. As seções a seguir descrevem como invocar e usar um modelo de linguagem grande implantado no DataWorks.
Pré-requisitos
Um grupo de recursos Serverless deve estar associado ao seu workspace do DataWorks.
Um serviço de modelo de linguagem grande deve estar implantado no grupo de recursos Serverless. Para mais informações, consulte Implantar um modelo de linguagem grande.
Preparações
Antes de invocar um modelo, garanta que sua aplicação tenha acesso ao serviço de modelo de linguagem grande. Para invocar o modelo, obtenha o endpoint do serviço e a chave de API para autenticação.
1. Configure a conectividade de rede
Certifique-se de que a VPC associada ao grupo de recursos do DataWorks usado para invocação de modelos esteja incluída na lista de VPCs com permissão para conexão ao modelo.
-
Identifique a primeira VPC associada ao seu grupo de recursos.
Acesse a página Grupos de Recursos do DataWorks. Na barra de navegação superior, mude para a região onde está o grupo de recursos desejado e localize-o na lista.
Clique em Operation na linha do grupo de recursos alvo e selecione Network Settings para abrir a página VPC Binding.
-
Em Data Scheduling & Data Integration, visualize o vSwitch CIDR Block correspondente.
ImportanteAo invocar um modelo de linguagem grande, use a primeira VPC listada na configuração de rede do grupo de recursos como base de comunicação.
Para visualizar a lista de VPCs permitidas para conexão ao modelo ou adicionar uma nova associação de VPC, consulte Gerencie rede do modelo.
2. Obter informações de invocação
Após a implantação, o serviço de modelo gera automaticamente um endpoint interno na mesma região. Acesse a página de detalhes do serviço de modelo para obter esse endpoint. O formato do nome de domínio é: http://<model-service-id>.<region>.dataworks-model.aliyuncs.com. Para instruções, consulte Visualize serviço de modelo.
3. Obter uma chave de API
Obtenha sua chave de API para autenticação em Gerencie Chave de API.
Invocar serviços de modelo de linguagem grande
É possível invocar modelos de linguagem grande no Data Integration e no Data Development para ative o processamento inteligente de dados.
Invocar no Data Integration
Em tarefas de sincronização offline para tabelas únicas, aplique o processamento assistido por IA aos dados durante a sincronização usando um serviço de modelo de linguagem grande.
Na aba Configuration do nó de AI-assisted processing, selecione um Model Provider (as opções incluem Alibaba Cloud DataWorks Model Service, Alibaba Cloud Model Studio e Alibaba Cloud PAI Model Marketplace). Em seguida, configure o Model Name, a Processing Task Description (por exemplo, tradução de texto, resumo de conteúdo ou análise de sentimentos) e o Target Field.
Invocar no Data Development
1. Usar um nó de modelo de linguagem grande
O Data Development do DataWorks permite usar um nó de modelo de linguagem grande para processar dados. Nesse nó, configure e invoque um serviço de modelo de linguagem grande.
2. Nó Shell invocando modelo de linguagem grande
Este exemplo demonstra como invocar um modelo de linguagem grande a partir de um nó Shell para responder a uma pergunta específica.
-
Crie um nó Shell e adicione o seguinte comando de exemplo:
NotaSubstitua o endpoint do serviço de modelo que começa com
httpe o token que começa comDWpelos valores reais obtidos na seção Preparações.curl -X POST http://ms-xxx.cn-beijing.dataworks-model.aliyuncs.com/v1/completions -H "Authorization: DW-ms-xxx" -H "Content-Type: application/json" -d '{"prompt":"Differences and connections among AI, machine learning, and deep learning", "stream":"false", "max_tokens": 1024}' -v Após editar o nó, no painel Run Configuration à direita do editor de nós, selecione o grupo de recursos com a configuração de conectividade de rede concluída com o serviço de modelo.
-
Clique em Run para invocar o serviço de modelo implantado.
NotaConfiguração de agendamento de nó: Se o nó precisar ser executado conforme um cronograma, selecione o grupo de recursos com a configuração de conectividade de rede concluída no painel Scheduling Settings à direita. Depois, configure as propriedades de agendamento em Scheduling Policy.
Publicação de nó: Para execute a tarefa em ambiente de produção, clique em ícone
na interface para iniciar o fluxo de trabalho de publicação. O nó só será executado conforme o cronograma após a publicação no ambiente de produção.
3. Invocar um modelo de linguagem grande com um nó Python
Este exemplo ilustra como invocar um modelo de linguagem grande a partir de um nó Python para gerar um poema.
-
Este exemplo requer a biblioteca Python
requests. Crie uma imagem personalizada baseada em uma Imagem do Alibaba Cloud para instale essa dependência. Use os seguintes parâmetros:Parâmetro de imagem personalizada
Descrição
Nome/ID da imagem
Selecione uma imagem compatível com Python na lista de imagens do DataWorks.
Tipo de tarefa suportado
Selecione Python.
Pacotes de instalação
-
Python3:
requests. -
Script:
/home/tops/bin/pip3 install 'urllib3<2,0'.
-
-
Crie um nó Python e adicione o seguinte código de exemplo:
NotaSubstitua o endpoint do serviço de modelo que começa com
httpe o token que começa comDWpelos valores reais obtidos na seção Preparações.import requests import json import time import sys def stream_print_response(): httpUrl = "http://ms-xxxx.cn-beijing.dataworks-model.aliyuncs.com" apikey = "DW-ms-xxxx" url = httpUrl + "/v1/completions" headers = { "Authorization": apikey, "Content-Type": "application/json" } data = { "prompt": "Write a poem about spring", "stream": True, "max_tokens": 512 } try: response = requests.post(url, headers=headers, json=data, stream=True) response.raise_for_status() full_text = "" # Accumulate full response to prevent loss buffer = "" # Optional: handle incomplete JSON lines for line in response.iter_lines(): if not line: continue # Skip empty lines line_str = line.decode('utf-8').strip() # print(f"[DEBUG] Received line: {line_str}") # For debugging if line_str.startswith("data:"): data_str = line_str[5:].strip() # Remove "data: " if data_str == "[DONE]": print("\n[Streaming response ended]") break # Attempt to parse JSON try: parsed = json.loads(data_str) choices = parsed.get("choices", []) if choices: delta_text = choices[0].get("text", "") if delta_text: # Accumulate into full text full_text += delta_text # Print characters one by one for char in delta_text: print(char, end='', flush=True) sys.stdout.flush() time.sleep(0.03) # Typewriter effect except json.JSONDecodeError as e: # print(f"[Warning] JSON parsing failed: {e}, raw: {data_str}") continue print(f"\n\n[Full response length: {len(full_text)} characters]") print(f"[ Full content]:\n{full_text}") except requests.exceptions.RequestException as e: print(f" Request failed: {e}") except Exception as e: print(f" Other error: {e}") if __name__ == "__main__": stream_print_response() Após editar o nó, no painel Run Configuration à direita, selecione o grupo de recursos com a configuração de conectividade de rede concluída e a Image personalizada da
etapa 1que inclui a bibliotecarequests.-
Clique em Run para invocar o serviço de modelo implantado.
NotaConfiguração de agendamento de nó: Se o nó precisar ser executado conforme um cronograma, selecione o grupo de recursos com a configuração de conectividade de rede concluída e a Image personalizada da
etapa 1que inclui a bibliotecarequestsno painel Scheduling Settings. Depois, configure as propriedades de agendamento em Scheduling Policy.Publicação de nó: Para execute a tarefa em ambiente de produção, clique em ícone
na interface para iniciar o fluxo de trabalho de publicação. O nó só será executado conforme o cronograma após a publicação no ambiente de produção.
Invocar serviços de modelo vetorial
É possível invocar modelos vetoriais no Data Integration e no Data Development para vetorizar dados. Os exemplos a seguir mostram como invocar um serviço de modelo vetorial BGE-M3 implantado em um grupo de recursos do DataWorks.
Invocar no Data Integration
Em tarefas de sincronização offline para tabelas únicas, aplique a vetorização aos dados durante a sincronização usando um serviço de modelo grande.
Após ative a opção Data Processing, adicione um nó de Data Vectorization à lista de processamento. No painel de configuração à direita, selecione um Model Provider (como Alibaba Cloud DataWorks Model Service) e o Model Name. Defina o Batch Size, escolha os campos de source para vetorizar (a ordem das colunas afeta o resultado final — arraste para reordenar) e insira um nome para o Vectorized Result Field. Também é possível expandir Advanced Options para configurações adicionais.
Invocar no Data Development
1. Nó LLM invoca serviço de modelo vetorial
O Data Development do DataWorks permite usar um nó de modelo grande para processar dados. Nesse nó, configure e invoque um serviço de modelo vetorial.
2. Nó Shell invoca modelo vetorial
Este exemplo demonstra como converter texto em vetores invocando um modelo vetorial a partir de um nó Shell.
-
Crie um nó Shell e adicione o seguinte comando de exemplo:
NotaSubstitua o endpoint do serviço de modelo que começa com
httpe o token que começa comDWpelos valores reais obtidos na seção Preparações.curl -X POST "http://ms-xxx.cn-beijing.dataworks-model.aliyuncs.com/v1/embeddings" \ -H "Authorization: DW-ms-xxx" \ -H "Content-Type: application/json" \ -d '{ "input": "This is a piece of text that needs to be converted into a vector", "model": "bge-m3" }' Após editar o nó, no painel Run Configuration à direita, selecione o grupo de recursos com a configuração de conectividade de rede concluída com o serviço de modelo.
-
Clique em Run para invocar o serviço de modelo implantado.
NotaConfiguração de agendamento de nó: Se o nó precisar ser executado conforme um cronograma, selecione o grupo de recursos com a configuração de conectividade de rede concluída no painel Scheduling Settings. Depois, configure as propriedades de agendamento em Scheduling Policy.
Publicação de nó: Para execute a tarefa em ambiente de produção, clique em ícone
na interface para iniciar o fluxo de trabalho de publicação. O nó só será executado conforme o cronograma após a publicação no ambiente de produção.
3. Invocar um modelo vetorial a partir de um nó Python
Este exemplo ilustra como converter texto em vetores invocando um modelo vetorial a partir de um nó Python.
-
Este exemplo requer a biblioteca Python
requests. Crie uma imagem personalizada baseada em uma Imagem do Alibaba Cloud para instale essa dependência. Use os seguintes parâmetros:Parâmetro de imagem personalizada
Descrição
Nome/ID da imagem
Selecione uma imagem compatível com Python na lista de imagens do DataWorks.
Tipo de tarefa suportado
Selecione Python.
Pacotes de instalação
-
Python3:
requests. -
Script:
/home/tops/bin/pip3 install 'urllib3<2,0'.
-
-
Crie um nó Python e adicione o seguinte código de exemplo:
NotaSubstitua o endpoint do serviço de modelo que começa com
httpe o token que começa comDWpelos valores reais obtidos na seção Preparações.import requests import json import sys # Replace with your API endpoint and token api_url = "http://ms-xxx.cn-beijing.dataworks-model.aliyuncs.com" + "/v1/embeddings" token = "DW-ms-xxx" print("api_url:"+api_url) print("token:"+token) headers = { "Authorization": f"{token}", "Content-Type": "application/json" } payload = { "input": "Test text", "model": "bge-m3" } try: response = requests.post(api_url, headers=headers, data=json.dumps(payload)) print("Response status code:", response.status_code) print("Response content:", response.text) # View detailed error messages except Exception as e: print("Request error:", e) Após editar o nó, no painel Run Configuration à direita, selecione o grupo de recursos com a configuração de conectividade de rede concluída e a Image personalizada da
etapa 1que inclui a bibliotecarequests.-
Clique em Run para invocar o serviço de modelo implantado.
NotaConfiguração de agendamento de nó: Se o nó precisar ser executado conforme um cronograma, selecione o grupo de recursos com a configuração de conectividade de rede concluída no painel Scheduling Settings. Depois, configure as propriedades de agendamento em Scheduling Policy.
Publicação de nó: Para execute a tarefa em ambiente de produção, clique em ícone
na interface para iniciar o fluxo de trabalho de publicação. O nó só será executado conforme o cronograma após a publicação no ambiente de produção.
Leitura relacionada
Para mais detalhes sobre comandos para invocar modelos de linguagem grande, consulte Servidor Compatível com OpenAI.