AgencyMod API

अपने AgencyMod को AgencyAI के साथ अपनी टिकट सिस्टम, वेबसाइट या हेल्पडेस्क में इस्तेमाल करें। यह डैशबोर्ड में सब कुछ के साथ जवाब देता है, नाम, टोन, स्तर, हिदायतें, जानकारी, दस्तावेज़ और जो आपकी टीम से सीखा है।

डैशबोर्ड खोलें AI सेटिंग

शुरुआत करें

01डैशबोर्ड खोलें, AI टैब, और AgencyMod API के अंतर्गत एक कुंजी बनाएँ। तुरंत कॉपी करें, यह सिर्फ़ एक बार दिखाई देती है।
02कुंजी को अपने सर्वर पर सेव करें। इसे कभी वेबसाइट, ऐप या कहीं भी न रखें जहाँ दूसरे लोग खोल सकें।
03API को टिकट की बातचीत भेजें Authorization: Bearer हेडर और अपनी कुंजी के साथ।
04अपनी टिकट में जवाब दिखाएँ। अगर needs_team सच है, तो अपनी टीम को सूचित करें।

उदाहरण

cURL

curl https://bot.agencyscripts.dev/api/v1/chat \
  -H "Authorization: Bearer amk_..." \
  -H "Content-Type: application/json" \
  -d '{"customer":"Alex","messages":[{"role":"user","content":"How do I join the server?"}]}'

JavaScript (Node.js)

const antwort = await fetch("https://bot.agencyscripts.dev/api/v1/chat", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.AGENCYMOD_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    customer: "Alex",
    messages: [
      { role: "user", content: "How do I join the server?" },
    ],
  }),
});
const { answer, needs_team } = await antwort.json();

PHP

$ch = curl_init("https://bot.agencyscripts.dev/api/v1/chat");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer " . getenv("AGENCYMOD_KEY"),
    "Content-Type: application/json",
  ],
  CURLOPT_POSTFIELDS => json_encode([
    "customer" => "Alex",
    "messages" => [["role" => "user", "content" => "How do I join the server?"]],
  ]),
]);
$antwort = json_decode(curl_exec($ch), true);

अनुरोध

JSON शरीर के साथ POST करें। ये फ़ील्ड पढ़ी जाती हैं: POST https://bot.agencyscripts.dev/api/v1/chat

messages: बातचीत, सबसे पुरानी पहले, 20 संदेशों तक। role ग्राहक के लिए user है और पहले के बॉट उत्तरों के लिए assistant है। content पाठ है। अंतिम संदेश user से होना चाहिए। अनिवार्य।
customer: ग्राहक का नाम, तो बॉट उन्हें संबोधित कर सकता है। वैकल्पिक।
messages[].name: संदेश के अंदर, जिस व्यक्ति ने लिखा उसका नाम। कई लोग एक टिकट में लिखें तो उपयोगी। वैकल्पिक।

जवाब

JSON

{
  "answer": "...",
  "needs_team": false,
  "bot": { "name": "AgencyMod", "avatar": "https://cdn.discordapp.com/..." },
  "level": "V1",
  "usage": {
    "available_percent": 92.5,
    "credit_percent": 0,
    "requests_today": 14,
    "requests_per_day": 1000,
    "requests_per_minute": 20,
    "premium": true
  },
  "ai_notice": "This answer was generated automatically by an AI (AgencyAI)."
}

answer: सादा पाठ के रूप में जवाब, सरल markdown के साथ।
needs_team: सच है अगर कोई इंसान ले, जैसे भुगतान, प्रतिबंध या समस्याओं के लिए जो बॉट नहीं कर सकता।
bot: आपकी ब्रांडिंग से नाम और तस्वीर, तो जवाब Discord जैसा दिखे।
level: किस स्तर (V1, V1.5 या V2) से AgencyAI ने जवाब दिया।
usage: बची हुई कोटा प्रतिशत में, आपकी जमा की गई राशि और अनुरोध की सीमा।
ai_notice: संक्षिप्त नोट कि जवाब AI ने लिखा है। अपने ग्राहकों को दिखाएँ, तो वे हमेशा जानें कि AI ने जवाब दिया।

अपनी कोटा चेक करें

/api/v1/status पर GET अनुरोध भेजें, उसी हेडर के साथ बॉट का नाम, तस्वीर और बची हुई कोटा मिल जाती है, बिना कोटा खर्च किए।

cURL

curl https://bot.agencyscripts.dev/api/v1/status \
  -H "Authorization: Bearer amk_..."

सीमा और कोटा

01Premium के साथ API आपके साप्ताहिक AI कोटा का आधा हिस्सा तक इस्तेमाल कर सकता है, ताकि Discord के लिए हमेशा कोटा बचा रहे। कोटा हर सोमवार को नया शुरू होता है।
02जब API कोटा खत्म हो, तो यह आपकी जमा की गई राशि से चलता है। जमा राशि डैशबोर्ड में AI टैब में है, और कभी खत्म नहीं होती।
03Premium के बिना, सबसे सरल स्तर पर छोटी परीक्षा कोटा दी जाती है। इसके लिए आपके सर्वर में कम से कम 20 सदस्य चाहिए और AgencyMod 7 दिन से चल रहा हो।
04हर कुंजी पर प्रति मिनट 20 अनुरोध, Premium के साथ दिन में 1,000 अनुरोध और बिना 150। हर सर्वर पर 5 तक कुंजी।

त्रुटियाँ

400: messages गायब है, या अंतिम संदेश user से नहीं है।
401: कुंजी गायब है, गलत है या रद्द की गई है।
402: कोटा खत्म हो गई है। जमा करवाएँ या Premium लें।
403: सर्वर Premium के बिना API के लिए आवश्यकताएँ अभी पूरी नहीं करता।
429: बहुत सारे अनुरोध। कुछ पल प्रतीक्षा करें और फिर से कोशिश करें।
503: AgencyAI ने जवाब नहीं दिया। फिर से कोशिश करें।

सुरक्षाजो कोई आपकी कुंजी रखता है वह आपकी AI कोटा इस्तेमाल करता है। अगर कुंजी बाहर आ गई, तो डैशबोर्ड में रद्द करें और नई बनाएँ। API आपके सर्वर से कॉल के लिए बनाया गया है, ब्राउज़र सीधे नहीं कॉल कर सकते।

बेहतर जवाबAPI Discord में अपने बॉट जैसी ही जानकारी इस्तेमाल करता है। AI टैब में जानकारी और दस्तावेज़ लिंक भरें, और हल की गई टिकटों से प्रशिक्षण सुझावों को मंजूरी दें। हर मंजूरी दी गई प्रविष्टि Discord और API दोनों को बेहतर बनाती है।

कुछ समझ नहीं आया? help.agencyg.de पर AgencyMod कैटेगरी में टिकट खोलें या हमारे Discord में पूछें। गोपनीयता नीति और उपयोग की शर्तें