Consultar un punto final de servicio (manual)

Descripción

Importante:

Esta actividad no recupera el esquema de entrada y salida del modelo. Por lo tanto, consulta la documentación de tu modelo y utilízala según las instrucciones.

Esta actividad te permite enviar una solicitud a un punto de conexión de servicio de Databricks componiendo manualmente la carga útil completa de JSON. A diferencia de la actividad Consultar un punto final de servicio , que genera automáticamente el esquema de solicitud en función del modelo seleccionado, esta actividad requiere que conozcas y proporciones la estructura de solicitud completa tú mismo.

Utiliza esta actividad cuando:

• El enfoque de esquema generado automáticamente no está disponible para su tipo de modelo.
• Necesitas un control total sobre la carga útil de JSON enviada al punto final.
• Está integrando con un punto final de servicio de Databricks personalizado o no estándar.

Cómo usar la actividad

Para utilizar esta actividad en un proceso agéntico de Maestro, sigue estos pasos:

1. Añade un elemento de tarea de servicio al lienzo y abre el panel Propiedades de la tarea.

2. En la sección Implementación , en la lista desplegable Acción , selecciona Iniciar y esperar al agente externo.

3. Selecciona el conector del agente de Databricks .

4. Seleccione una conexión existente o cree una nueva. Para obtener más información, consulta Autenticación del agente de Databricks.

5. Desde Actividad, selecciona Consultar un punto final de servicio (manual).

6. En Punto final de servicio, selecciona el punto final de servicio que deseas invocar.

7. En el campo Entrada , introduce la carga útil JSON completa para enviar al punto final. La estructura de carga útil esperada depende de tu modelo; consulta su documentación.

   Por ejemplo, para un modelo basado en chat, la carga útil podría tener el siguiente aspecto:

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

8. Conecta el evento de inicio a la tarea de servicio y la tarea de servicio a un nodo de evento final en el lienzo.

9. Selecciona Depurar para ejecutar el proceso. Después de una ejecución correcta, revisa las variables globales y busca la respuesta de la tarea de servicio.

Solución de problemas y ajustes

Como esta actividad no recupera el esquema de entrada y salida del modelo, la estructura de la solicitud y la forma de la respuesta dependen completamente del punto final de servicio al que se llama. Consulta la documentación del modelo en tu espacio de trabajo de Databricks para entender:

• Los campos JSON necesarios y sus tipos.
• La estructura del objeto de respuesta devuelto por el punto final.

Recomendamos probar la carga útil directamente en tu espacio de trabajo de Databricks primero para confirmar la entrada y salida esperadas antes de integrarla en un proceso de Maestro.