REST API से इंटीग्रेशन: अपने सिस्टम्स में एजेंट और डेटा

कंसोल में मौजूद सब कुछ REST API के ज़रिए उपलब्ध है, इसलिए आप अपनी वेबसाइट, मोबाइल ऐप, CRM या कॉन्टैक्ट सेंटर में एजेंट्स का इस्तेमाल कर सकते हैं और डेटा अपने-आप push कर सकते हैं।

1. Key बनाएँ

कंसोल में API & keys खोलें, key को एक ऐसा नाम दें जो बताए कि वह कहाँ इस्तेमाल हो रही है (जैसे mobile-app-prod) और Create key पर क्लिक करें। इसे अभी कॉपी कर लें: सिर्फ़ एक fingerprint सेव किया जाता है, इसलिए key दोबारा नहीं दिखाई जा सकती। इसे अपने सर्वर के secrets में रखें, कभी भी ऐसी वेबसाइट या ऐप में नहीं जिसे ग्राहक डाउनलोड कर सकते हैं।

2. एजेंट को कॉल करें

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 राउटर को एजेंट चुनने देता है; या personal-shopper जैसी कोई खास key इस्तेमाल करें।
• "stream": true जोड़ें ताकि जवाब token-दर-token (server-sent events) मिले, साथ ही product, store और return events भी मिलें जिन्हें आप cards की तरह दिखा सकते हैं।

3. डेटा push करें

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

फ़ाइल अपने-आप map होकर process हो जाती है। प्रगति देखने के लिए GET /api/v1/datasets/{id} इस्तेमाल करें।

Endpoints

Key revoke करें

उसके आगे Revoke पर क्लिक करें। उस key से होने वाले calls तुरंत बंद हो जाते हैं।