API AgencyMod

Folosește AgencyMod cu AgencyAI în propriul sistem de ticket-uri, pe site sau în helpdesk. Răspunde cu tot ce ai setat în panou: nume, ton, nivel, instrucțiuni, cunoștințe, documentație și ce a învățat din echipa ta.

Deschide panoul de control Setări IA

Începe

01Deschide panoul, fila IA, și creează o cheie la API AgencyMod. Copiaz-o imediat, este afișată o singură dată.
02Păstrează cheia pe serverul tău. Nu o pune niciodată pe un site, într-o aplicație sau în ceva ce alți oameni pot deschide.
03Trimite conversația unui ticket către API cu antetul Authorization: Bearer și cheia ta.
04Arată răspunsul în ticket-ul tău. Dacă needs_team este true, anunță echipa.

Exemplu

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);

Cerere

POST cu un corp JSON. Se citesc aceste câmpuri: POST https://bot.agencyscripts.dev/api/v1/chat

messages: Conversația, cel mai vechi mesaj primul, până la 20 de mesaje. role este user pentru client și assistant pentru răspunsurile anterioare ale botului, content este textul. Ultimul mesaj trebuie să vină de la user. Obligatoriu.
customer: Numele clientului, ca botul să se poată adresa lui. Opțional.
messages[].name: În interiorul unui mesaj: numele persoanei care l-a scris, util când mai mulți scriu în același ticket. Opțional.

Răspuns

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: Răspunsul ca text simplu, cu markdown simplu.
needs_team: true dacă un om trebuie să preia, de exemplu pentru plăți, bannuri sau probleme pe care botul nu le poate rezolva.
bot: Nume și avatar din branding-ul tău, ca să arăți răspunsul exact ca în Discord.
level: Nivelul AgencyAI care a răspuns: V1, V1.5 sau V2.
usage: Cota rămasă în procente, creditul tău de reîncărcare și limitele tale de cereri.
ai_notice: O scurtă notă că răspunsul a fost scris de o IA. Arat-o clienților tăi, ca ei să știe mereu că a răspuns o IA.

Verifică-ți cota

O cerere GET către /api/v1/status, cu același antet, returnează numele și avatarul botului și cota ta rămasă, fără să consume nimic din ea.

cURL

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

Limite și cotă

01Cu Premium, API-ul poate folosi până la jumătate din cota ta săptămânală de IA, astfel încât mereu rămâne cotă pentru Discord. Cota se resetează în fiecare luni.
02Când cota API este epuizată, continuă cu creditul tău de reîncărcare. Reîncărcările se fac în panou, fila IA, și nu expiră niciodată.
03Fără Premium primești o mică cotă de probă pe nivelul V1. Are nevoie de cel puțin 20 de membri și de AgencyMod pe serverul tău timp de 7 zile.
0420 de cereri pe minut per cheie, 1,000 de cereri pe zi cu Premium și 150 fără. Până la 5 chei per server.

Erori

400: messages lipsește sau ultimul mesaj nu vine de la user.
401: Cheia lipsește, este greșită sau a fost revocată.
402: Cota este epuizată. Reîncarcă sau ia Premium.
403: Serverul nu îndeplinește încă cerințele pentru API fără Premium.
429: Prea multe cereri. Așteaptă puțin și încearcă din nou.
503: AgencyAI nu a răspuns. Încearcă din nou.

SecuritateOricine are cheia ta consumă cota ta de IA. Dacă o cheie se scurge, revocă-o în panou și creează una nouă. API-ul este făcut pentru apeluri de pe serverul tău, browserele nu pot apela direct.

Răspunsuri mai buneAPI-ul folosește aceleași cunoștințe ca botul tău din Discord. Completează cunoștințele și linkurile de documentație în fila IA și aprobă sugestiile de antrenament din ticket-urile rezolvate. Fiecare intrare aprobată îmbunătățește Discord și API-ul deodată.

Ceva nu e clar? Deschide un ticket la help.agencyg.de în categoria AgencyMod sau întreabă pe Discordul nostru. Politica de confidențialitate și termenii