AgencyMod API

استخدم AgencyMod الخاص بك مع AgencyAI في نظام التذاكر الخاص بك أو موقعك أو مكتب المساعدة. يرد مع كل ما حددته في لوحة التحكم: الاسم والنبرة والمستوى والتعليمات والمعرفة والوثائق وما تعلمه من فريقك.

فتح لوحة التحكم إعدادات الذكاء الاصطناعي

البدء

01افتح لوحة التحكم وتبويب الذكاء الاصطناعي، وأنشئ مفتاح تحت AgencyMod API. انسخه على الفور، يُعرض مرة واحدة فقط.
02احفظ المفتاح على خادمك. لا تضعه أبداً في موقع ويب أو تطبيق أو أي شيء قد يفتحه الآخرون.
03أرسل محادثة التذكرة إلى API باستخدام رأس 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);

الطلب

POST مع جسم JSON. تُقرأ هذه الحقول: 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: مستوى AgencyAI الذي أجاب: V1 أو V1.5 أو V2.
usage: الحصة المتبقية كنسبة مئوية وحسابك المضاف والحدود المطلوبة.
ai_notice: ملاحظة قصيرة بأن الإجابة كتبتها AI. اعرضها لعملائك حتى يعرفوا دائماً أن AI أجابت.

تحقق من حصتك

طلب GET إلى /api/v1/status بنفس الرأس يرجع اسم البوت والصورة وحصتك المتبقية، بدون استخدام أي منها.

cURL

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

الحدود والحصة

01مع Premium يمكن للـ API استخدام ما يصل إلى نصف حصتك الأسبوعية من AI، بحيث تبقى دائماً حصة Discord. تُعاد تعيين الحصة كل يوم إثنين.
02عندما تكون حصة API فارغة، تستمر مع حسابك المضاف. الإضافات موجودة في لوحة التحكم في تبويب الذكاء الاصطناعي، ولا تنتهي أبداً.
03بدون Premium تحصل على حصة تجريبية صغيرة على مستوى V1. يحتاج إلى 20 عضو على الأقل و AgencyMod على خادمك لمدة 7 أيام.
0420 طلب في الدقيقة لكل مفتاح، 1000 طلب في اليوم مع Premium و150 بدونها. ما يصل إلى 5 مفاتيح لكل خادم.

أخطاء

400: messages غير موجود، أو آخر رسالة ليست من user.
401: المفتاح غير موجود أو خاطئ أو تم إلغاؤه.
402: الحصة مستنزفة. أضف أو احصل على Premium.
403: الخادم لا يفي بمتطلبات API بدون Premium حتى الآن.
429: طلبات كثيرة جداً. انتظر لحظة وحاول مرة أخرى.
503: AgencyAI لم تجيب. حاول مرة أخرى.

الأمانأي شخص لديه مفتاحك يستخدم حصة AI الخاصة بك. إذا تسرب مفتاح، أبطله في لوحة التحكم وأنشئ واحداً جديداً. API مخصصة لنداءات من خادمك، المتصفحات لا تستطيع استدعاؤها مباشرة.

إجابات أفضلتستخدم API نفس المعرفة مثل بوتك في Discord. املأ المعرفة وروابط الوثائق في تبويب الذكاء الاصطناعي، وافق على اقتراحات التدريب من التذاكر المحلولة. كل مدخل موافق عليه يحسّن Discord والـ API في نفس الوقت.

هل هناك شيء غير واضح؟ افتح تذكرة على help.agencyg.de ضمن فئة AgencyMod، أو اسأل في خادم Discord الخاص بنا. سياسة الخصوصية وشروط الاستخدام