AgencyMod API

ใช้ AgencyMod ของคุณร่วมกับ AgencyAI ในระบบติกเก็ต เว็บไซต์ หรือ helpdesk ของคุณเอง ระบบจะตอบด้วยทุกอย่างที่คุณตั้งไว้ในแดชบอร์ด ได้แก่ ชื่อ น้ำเสียง ระดับ คำสั่ง ความรู้ เอกสาร และสิ่งที่เรียนรู้จากทีมของคุณ

เปิดแดชบอร์ด การตั้งค่า AI

เริ่มต้นใช้งาน

01เปิดแดชบอร์ด แท็บ AI แล้วสร้างคีย์ใต้ AgencyMod API คัดลอกไว้ทันที เพราะจะแสดงเพียงครั้งเดียว
02เก็บคีย์ไว้ในเซิร์ฟเวอร์ของคุณ อย่าใส่ในเว็บไซต์ แอป หรือที่ที่คนอื่นเปิดได้
03ส่งบทสนทนาของติกเก็ตไปยัง API พร้อม header Authorization: Bearer และคีย์ของคุณ
04แสดงคำตอบในติกเก็ตของคุณ หาก needs_team เป็น true ให้แจ้งทีมของคุณ

ตัวอย่าง

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: เป็น true เมื่อควรให้คนเข้ามาดูแลต่อ เช่น เรื่องการชำระเงิน การแบน หรือปัญหาที่บอตแก้ไม่ได้
bot: ชื่อและอวาตาร์จากแบรนด์ของคุณ เพื่อแสดงคำตอบเหมือนใน Discord
level: ระดับ AgencyAI ที่ตอบ: V1, V1.5 หรือ V2
usage: โควต้าที่เหลือเป็นเปอร์เซ็นต์ เครดิตเติมเงิน และขีดจำกัดคำขอของคุณ
ai_notice: หมายเหตุสั้น ๆ ว่าคำตอบถูกเขียนโดย AI แสดงให้ลูกค้าของคุณเห็น เพื่อให้พวกเขารู้เสมอว่ามี AI ตอบ

ตรวจสอบโควต้าของคุณ

คำขอ GET ไปที่ /api/v1/status พร้อม header เดียวกัน จะคืนชื่อและอวาตาร์ของบอต และโควต้าที่เหลือของคุณ โดยไม่ใช้โควต้าใด ๆ

cURL

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

ขีดจำกัดและโควต้า

01ด้วย Premium API ใช้ได้สูงสุดครึ่งหนึ่งของโควต้า AI รายสัปดาห์ของคุณ เพื่อให้ยังมีโควต้าเหลือให้ Discord เสมอ โควต้ารีเซ็ตทุกวันจันทร์
02เมื่อโควต้า API หมด ระบบจะใช้เครดิตเติมเงินของคุณต่อ การเติมเงินทำได้ในแดชบอร์ด แท็บ AI และไม่มีวันหมดอายุ
03หากไม่มี Premium คุณจะได้โควต้าทดลองขนาดเล็กในระดับ V1 ต้องมีสมาชิกอย่างน้อย 20 คนและ AgencyMod อยู่บนเซิร์ฟเวอร์ของคุณเป็นเวลา 7 วัน
0420 คำขอต่อนาทีต่อคีย์ 1,000 คำขอต่อวันด้วย Premium และ 150 คำขอหากไม่มี สูงสุด 5 คีย์ต่อเซิร์ฟเวอร์

ข้อผิดพลาด

400: ไม่มี messages หรือข้อความสุดท้ายไม่ได้มาจาก user
401: ไม่มีคีย์ คีย์ไม่ถูกต้อง หรือถูกเพิกถอนแล้ว
402: โควต้าหมดแล้ว เติมเงินหรือรับ Premium
403: เซิร์ฟเวอร์ยังไม่ตรงตามเงื่อนไขการใช้ API โดยไม่มี Premium
429: คำขอมากเกินไป กรุณารอสักครู่แล้วลองอีกครั้ง
503: AgencyAI ไม่ตอบ กรุณาลองอีกครั้ง

ความปลอดภัยทุกคนที่มีคีย์ของคุณจะใช้โควต้า AI ของคุณได้ หากคีย์รั่วไหล ให้เพิกถอนในแดชบอร์ดและสร้างใหม่ API ออกแบบมาสำหรับการเรียกจากเซิร์ฟเวอร์ของคุณ เบราว์เซอร์เรียกโดยตรงไม่ได้

คำตอบที่ดีขึ้นAPI ใช้ความรู้ชุดเดียวกับบอตของคุณใน Discord กรอกความรู้และลิงก์เอกสารในแท็บ AI และอนุมัติข้อเสนอแนะการฝึกสอนจากติกเก็ตที่แก้ไขแล้ว ทุกรายการที่อนุมัติจะปรับปรุงทั้ง Discord และ API พร้อมกัน

มีอะไรไม่ชัดเจนไหม เปิดตั๋วที่ help.agencyg.de ในหมวด AgencyMod หรือถามในเซิร์ฟเวอร์ Discord ของเรา นโยบายความเป็นส่วนตัวและข้อกำหนด