AgencyMod API

AgencyMod'unu AgencyAI ile kendi bilet sisteminde, web sitende ya da yardım masanda kullan. Panelde ayarladığın her şeyle yanıt verir: ad, ton, seviye, talimatlar, bilgi, dokümantasyon ve ekibinden öğrendikleri.

Paneli aç AI ayarları

Başlarken

01Paneli aç, AI sekmesine git ve AgencyMod API altında bir anahtar oluştur. Hemen kopyala, yalnızca bir kez gösterilir.
02Anahtarı sunucunda sakla. Asla bir web sitesine, uygulamaya ya da başkalarının açabileceği bir yere koyma.
03Bir biletin konuşmasını, Authorization: Bearer başlığı ve anahtarınla API'ye gönder.
04Yanıtı biletinde göster. needs_team true ise ekibine haber ver.

Örnek

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

İstek

JSON gövdesiyle POST. Şu alanlar okunur: POST https://bot.agencyscripts.dev/api/v1/chat

messages: Konuşma, en eskisi önce, en fazla 20 mesaj. role müşteri için user, önceki bot yanıtları için assistant; content metindir. Son mesaj user'dan gelmelidir. Zorunlu.
customer: Müşterinin adı, böylece bot ona hitap edebilir. İsteğe bağlı.
messages[].name: Bir mesajın içinde: mesajı yazan kişinin adı; aynı biletinde birkaç kişi yazdığında işe yarar. İsteğe bağlı.

Yanıt

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: Yanıt, basit markdown içeren düz metin olarak.
needs_team: Bir insanın devralması gerekiyorsa true; örneğin ödemeler, yasaklar ya da botun çözemediği sorunlar için.
bot: Markanızdaki ad ve avatar; yanıtı tıpkı Discord'daki gibi göstermek için.
level: Yanıtı veren AgencyAI seviyesi: V1, V1.5 veya V2.
usage: Yüzde olarak kalan kota, yükleme kredin ve istek sınırların.
ai_notice: Yanıtın bir AI tarafından yazıldığını belirten kısa bir not. Müşterilerine göster, böylece bir AI'ın yanıtladığını her zaman bilirler.

Kotanı kontrol et

Aynı başlıkla /api/v1/status adresine yapılan bir GET isteği, botun adını ve avatarını ile kalan kotanı döndürür; kotadan hiçbir şey kullanmaz.

cURL

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

Sınırlar ve kota

01Premium ile API, haftalık AI kotanın en fazla yarısını kullanabilir; böylece Discord için her zaman kota kalır. Kota her Pazartesi sıfırlanır.
02API kotası bittiğinde yükleme kredinle devam eder. Yüklemeler panelde AI sekmesindedir ve asla sona ermez.
03Premium olmadan V1 seviyesinde küçük bir deneme kotası alırsın. Sunucunda en az 20 üye ve 7 gün boyunca AgencyMod gerekir.
04Anahtar başına dakikada 20 istek; Premium ile günde 1.000, Premium olmadan 150 istek. Sunucu başına en fazla 5 anahtar.

Hatalar

400: messages eksik ya da son mesaj user'dan gelmiyor.
401: Anahtar eksik, yanlış ya da iptal edilmiş.
402: Kota bitti. Yükleme yap ya da Premium al.
403: Sunucu, Premium olmadan API için gereken koşulları henüz karşılamıyor.
429: Çok fazla istek. Biraz bekle ve tekrar dene.
503: AgencyAI yanıt vermedi. Tekrar dene.

GüvenlikAnahtarı olan herkes AI kotanı kullanır. Bir anahtar sızarsa panelden iptal et ve yenisini oluştur. API, sunucundan yapılan çağrılar için tasarlandı; tarayıcılar onu doğrudan çağıramaz.

Daha iyi yanıtlarAPI, Discord'daki botunla aynı bilgiyi kullanır. AI sekmesinde bilgiyi ve dokümantasyon bağlantılarını doldur, çözülmüş biletlerden gelen eğitim önerilerini onayla. Onaylanan her giriş Discord'u ve API'yi aynı anda iyileştirir.

Bir şey anlaşılmadı mı? help.agencyg.de adresinde AgencyMod kategorisinde bir ticket aç ya da Discord sunucumuzda sor. Gizlilik politikası ve kullanım koşulları