Aller au contenu principal
Actions

Récupérer des données en direct pendant l'appel

Laissez l'agent interroger votre système sur une commande, un niveau de stock ou un compte pendant que l'appelant patiente.

Avec Outil API RAG, l'agent demande à votre système des données en direct au milieu de la conversation — le statut d'une commande, le stock d'un produit, les informations d'un compte — et répond avec. L'agent décide quand l'utiliser, d'après votre description.

Le configurer​

  1. Ajouter l'outil

    Ouvrez l'agent → Actions → Ajouter un outil → CRM et services → Outil API RAG.

  2. Le décrire et le diriger vers votre endpoint
    ChampCe qu'il faut saisir
    Nomp. ex. Recherche de commande
    Condition généraleQuand l'utiliser, p. ex. le client demande le statut d'une commande
    URL du point de terminaison APIp. ex. https://api.yourshop.com/orders/{order_id} — les {placeholders} sont remplis avec les valeurs recueillies par l'agent
    Méthode HTTPGET, POST, PUT, DELETE ou PATCH
    Message d'exécutionCe que dit l'agent pendant qu'il attend, p. ex. Un instant, je vérifie votre commande
    Délai d'expiration de la requête (ms)Combien de temps attendre votre réponse ; 5000 par défaut
    En-têtes, Paramètres de requêteValeurs fixes facultatives, p. ex. votre clé API
  3. Indiquer ce que l'agent doit recueillir

    Le Schéma des paramètres (JSON) liste les valeurs que l'agent obtient de l'appelant et envoie — voir plus bas. Si une valeur obligatoire manque, l'agent la demande d'abord.

astuce

Remplissez toujours le Message d'exécution — un silence pendant la requête ressemble à un appel coupé.

Le schéma des paramètres​

Ce n'est pas le corps de la requête lui-même, mais un JSON Schema des valeurs à recueillir. Où elles arrivent :

CasOù va la valeur
L'URL contient {name}Dans l'URL
GET, DELETELe reste en ?key=value
POST, PUT, PATCHLe reste en corps JSON

Une recherche de commande par numéro :

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "description": "Le numéro de commande demandé par le client, généralement de 6 à 10 chiffres. Demande-le s'il n'est pas donné."
    }
  },
  "required": ["order_id"]
}

Une réservation avec plusieurs valeurs :

{
  "type": "object",
  "properties": {
    "product_id": { "type": "string", "description": "ID du produit issu d'une recherche précédente." },
    "quantity": { "type": "integer", "minimum": 1, "maximum": 10, "description": "Combien. 1 par défaut." },
    "delivery_method": { "type": "string", "enum": ["pickup", "home_delivery", "locker"], "description": "Comment le client veut le recevoir." },
    "customer_email": { "type": "string", "format": "email", "description": "E-mail pour la confirmation. Demande-le s'il n'est pas donné." }
  },
  "required": ["product_id", "delivery_method", "customer_email"]
}

Un endpoint statique, p. ex. les horaires d'ouverture : { "type": "object", "properties": {} }.

De bons schémas pour la voix :

  • Restez à plat : 3 à 5 valeurs.
  • Rédigez une description pour chaque valeur, avec des exemples — c'est ce qui guide le mieux l'agent.
  • Utilisez enum pour les choix fixes : l'agent associe « le bleu » à blue.
  • Ne marquez une valeur required que si la requête ne peut pas fonctionner sans elle.
  • Utilisez des noms en snake_case qui correspondent aux {placeholders} de l'URL.

Cas d'usage​

  • Statut de commande — « Où en est ma commande 482913 ? »
  • Disponibilité — vérifier le stock ou une table libre dans votre propre système.
  • Questions sur le compte — solde, fin de contrat, tickets ouverts.

Problèmes fréquents​

ProblèmeCe qu'il faut vérifier
L'agent ne l'utilise jamaisFaites en sorte que la Condition générale nomme la demande
Votre endpoint reçoit des valeurs videsLes noms du schéma doivent correspondre exactement aux {placeholders}
L'agent dit qu'il n'a pas pu vérifierVotre endpoint a mis plus de temps que le délai d'expiration, ou a répondu par une erreur
Sur cette page