Interroger un point de terminaison de service (Manuelle)

Utiliser le connecteur Uipath pour interroger un point de terminaison de service (manuel).

Description

Important :

Cette activité ne récupère pas le schéma d’entrée et de sortie du modèle. Par conséquent, veuillez vous référer à la documentation de votre modèle et l'utiliser comme indiqué.

Cette activité vous permet d'envoyer une requête à un point de terminaison du service Databricks en composant manuellement la charge utile JSON complète. Contrairement à l'activité Interroger un point de terminaison de service , qui génère automatiquement le schéma de requête en fonction du modèle sélectionné, cette activité vous oblige à connaître et à fournir vous-même la structure de la requête complète.

Utilisez cette activité lorsque :

• L’approche de schéma généré automatiquement n’est pas disponible pour votre type de modèle.
• Vous avez besoin d'un contrôle total sur la charge utile JSON envoyée au point de terminaison.
• Vous intégrez un point de terminaison de service Databricks personnalisé ou non standard.

Comment utiliser l’activité

Pour utiliser cette activité dans un processus agentique Maestro, procédez comme suit :

1. Ajoutez un élément de tâche de service à la zone de dessin et ouvrez le panneau Propriétés de la tâche.

2. Dans la section Implementation , de la liste déroulante Action , sélectionnez Start and wait for external agent.

3. Sélectionnez le connecteur Databricks Agent .

4. Sélectionnez une connexion existante ou créez-en une nouvelle. Pour plus d'informations, consultez la section Authentification de l'agent Databricks.

5. Dans Activité, sélectionnez Interroger un point de terminaison de service (Manuelle).

6. Dans Point de terminaison de service, sélectionnez le point de terminaison de service à invoquer.

7. Dans le champ Entrée , saisissez la charge utile JSON complète à envoyer au point de terminaison. La structure de charge utile attendue dépend de votre modèle, reportez-vous à sa documentation.

   Par exemple, pour un modèle basé sur le chat, la charge utile peut ressembler à :

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

8. Connectez l'événement de début à la tâche de service et la tâche de service à un nœud d'événement de fin sur le canevas.

9. Sélectionnez Déboguer pour exécuter le processus. Après une exécution réussie, examinez les variables globales et recherchez la réponse de la tâche de service.

Dépannage et réglage

Étant donné que cette activité ne récupère pas le schéma d'entrée et de sortie du modèle, la structure de la requête et la forme de la réponse dépendent entièrement du point de terminaison de service que vous appelez. Reportez-vous à la documentation du modèle dans votre espace de travail Databricks pour comprendre :

• Les champs JSON requis et leurs types.
• La structure de l’objet de réponse renvoyé par le point de terminaison.

Nous vous recommandons de tester la charge utile directement dans votre espace de travail Databricks pour confirmer l'entrée et la sortie attendues avant de l'intégrer dans un processus Maestro.