AgencyMod API

AgencyMod를 AgencyAI와 함께 여러분의 티켓 시스템, 웹사이트, 헬프데스크에서 사용하세요. 대시보드에서 설정한 모든 내용으로 답변해요. 이름, 말투, 레벨, 지침, 지식, 문서, 그리고 팀에게 배운 내용까지요.

대시보드 열기 AI 설정

시작하기

01대시보드의 AI 탭을 열고, AgencyMod API에서 키를 만드세요. 한 번만 보여주니 바로 복사하세요.
02키는 서버에 보관하세요. 웹사이트, 앱, 다른 사람이 볼 수 있는 곳에는 절대 넣지 마세요.
03Authorization: Bearer 헤더와 키를 함께 넣어서, 티켓의 대화를 API로 보내세요.
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);

요청

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: 간단한 마크다운이 있는 일반 텍스트 답변이에요.
needs_team: 결제, 차단, 봇이 해결할 수 없는 문제처럼 사람이 맡아야 하면 true예요.
bot: 브랜딩의 이름과 아바타예요. 디스코드에서처럼 답변을 보여줄 때 써요.
level: 답변한 AgencyAI 레벨이에요: V1, V1.5 또는 V2.
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 사용량의 최대 절반까지 쓸 수 있어서, 디스코드용 사용량이 항상 남아 있어요. 사용량은 매주 월요일에 초기화돼요.
02API 사용량을 다 쓰면 충전 크레딧으로 계속 작동해요. 충전은 대시보드의 AI 탭에서 하며, 만료되지 않아요.
03Premium이 없으면 V1 레벨의 작은 체험 사용량을 받아요. 서버에 멤버 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는 디스코드 봇과 같은 지식을 써요. AI 탭에서 지식과 문서 링크를 채우고, 해결된 티켓에서 나온 학습 제안을 승인하세요. 승인된 항목 하나하나가 디스코드와 API를 동시에 개선해요.

잘 이해되지 않나요? help.agencyg.de에서 AgencyMod 카테고리로 티켓을 열거나 저희 Discord에서 물어보세요. 개인정보 처리방침 및 이용약관