Todos os produtos
Search
Central de documentação

DataWorks:Usar modelos de linguagem grandes

Última atualização: Jun 27, 2026

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

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.

  1. Identifique a primeira VPC associada ao seu grupo de recursos.

    1. 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.

    2. Clique em Operation na linha do grupo de recursos alvo e selecione Network Settings para abrir a página VPC Binding.

    3. Em Data Scheduling & Data Integration, visualize o vSwitch CIDR Block correspondente.

      Importante

      Ao 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.

  2. 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.

  1. Crie um nó Shell e adicione o seguinte comando de exemplo:

    Nota

    Substitua o endpoint do serviço de modelo que começa com http e o token que começa com DW pelos 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    
  2. 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.

  3. Clique em Run para invocar o serviço de modelo implantado.

    Nota
    • Configuraçã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 image 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.

  1. 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'.

  2. Crie um nó Python e adicione o seguinte código de exemplo:

    Nota

    Substitua o endpoint do serviço de modelo que começa com http e o token que começa com DW pelos 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()
    
  3. 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 1 que inclui a biblioteca requests.

  4. Clique em Run para invocar o serviço de modelo implantado.

    Nota
    • Configuraçã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 1 que inclui a biblioteca requests 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 image 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.

  1. Crie um nó Shell e adicione o seguinte comando de exemplo:

    Nota

    Substitua o endpoint do serviço de modelo que começa com http e o token que começa com DW pelos 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"
          }'
  2. 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.

  3. Clique em Run para invocar o serviço de modelo implantado.

    Nota
    • Configuraçã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 image 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.

  1. 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'.

  2. Crie um nó Python e adicione o seguinte código de exemplo:

    Nota

    Substitua o endpoint do serviço de modelo que começa com http e o token que começa com DW pelos 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)
  3. 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 1 que inclui a biblioteca requests.

  4. Clique em Run para invocar o serviço de modelo implantado.

    Nota
    • Configuraçã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 image 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.