Intégrez l'API REST : les agents et les données dans vos propres systèmes

Tout ce qui se trouve dans la console est disponible via une API REST, ce qui vous permet d'utiliser les agents dans votre propre site web, application mobile, CRM ou centre de contact, et de pousser des données automatiquement.

1. Créer une clé

Dans la console, ouvrez API & clés, donnez à la clé un nom indiquant où elle est utilisée (par ex. mobile-app-prod) et cliquez sur Créer une clé. Copiez-la maintenant : seule une empreinte est conservée, elle ne pourra donc plus être affichée. Gardez-la dans les secrets de votre serveur, jamais dans un site web ou une application que les clients peuvent télécharger.

2. Appeler un agent

curl https://servicebuddy.com/api/v1/agents/auto/runs \
  -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Where is my order 1004?"}]}'

• auto laisse le routeur choisir l'agent ; ou utilisez une clé spécifique telle que personal-shopper.
• Ajoutez "stream": true pour recevoir la réponse token par token (server-sent events), ainsi que des événements produit, magasin et retour que vous pouvez afficher sous forme de cartes.

3. Pousser des données

curl https://servicebuddy.com/api/v1/datasets -H "Authorization: Bearer $API_KEY" \
  -F entity=product -F [email protected]

Le fichier est mappé et traité automatiquement. Vérifiez la progression avec GET /api/v1/datasets/{id}.

Endpoints

Révoquer une clé

Cliquez sur Révoquer à côté de celle-ci. Les appels utilisant cette clé s'arrêtent immédiatement.