Consultar um endpoint de serviço (manual)

Description

Importante:

Essa atividade não recupera o esquema de entrada e saída do modelo. Portanto, consulte a documentação do seu modelo e use-a conforme as instruções.

Esta atividade permite que você envie uma solicitação para um ponto de extremidade de serviço do Databricks compondo manualmente a carga completa do JSON. Ao contrário da atividade Consultar um endpoint de serviço , que gera automaticamente o esquema de solicitação com base no modelo selecionado, essa atividade requer que você conheça e forneça a estrutura completa da solicitação por conta própria.

Use esta atividade quando:

• A abordagem de esquema gerado automaticamente está indisponível para o seu tipo de modelo.
• Você precisa de controle total sobre a carga JSON enviada para o endpoint.
• Você está se integrando a um ponto de extremidade de serviço Databricks personalizado ou não padrão.

Como usar a atividade

Para usar essa atividade em um processo com agente do Maestro, siga estas etapas:

1. Adicione um elemento de tarefa de serviço à tela e abra o painel de Propriedades da tarefa.

2. Na seção Implementação , na lista suspensa Ação , selecione Iniciar e aguardar agente externo.

3. Selecione o conector do agente Databricks .

4. Selecione uma conexão existente ou crie uma nova. Para obter mais informações, consulte Autenticação do agente do Databricks.

5. Em Atividade, selecione Consultar um endpoint de serviço (manual).

6. Em Ponto de extremidade de serviço, selecione o ponto de extremidade de serviço para invocar.

7. No campo Entrada , insira a carga completa do JSON para enviar para o ponto de extremidade. A estrutura de carga esperada depende do seu modelo — consulte sua documentação.

   Por exemplo, para um modelo baseado em chat, a carga pode ser semelhante a:

   {
     "messages": [
       {
         "role": "user",
         "content": "What is the capital of France?"
       }
     ]
   }
   

8. Conecte o evento de início à tarefa de serviço, e a tarefa de serviço a um nó de evento final na tela.

9. Selecione Depurar para executar o processo. Após uma execução bem-sucedida, revise as variáveis globais e procure a resposta da tarefa de serviço.

Solução de problemas e ajuste

Como essa atividade não recupera o esquema de entrada e saída do modelo, a estrutura da solicitação e o formato da resposta dependem totalmente do endpoint de serviço que você está chamando. Consulte a documentação do modelo em seu espaço de trabalho do Databricks para entender:

• Os campos JSON necessários e seus tipos.
• A estrutura do objeto de resposta retornado pelo endpoint.

Recomendamos testar a carga diretamente em seu espaço de trabalho do Databricks primeiro para confirmar a entrada e saída esperadas antes de integrá-la a um processo do Maestro.