✦ چیستادمو · ایجنت‌ها · ابزارهای رایگان · گالری · وضعیت

APIِ چیستا برای توسعه‌دهنده‌ها

ایجنت‌های چیستا را از داخلِ نرم‌افزار، سایت یا اتوماسیونِ خودت صدا بزن. هزینه از همان کیف پول کم می‌شود.

۱) کلید بساز

داخلِ اپ: تنظیمات ← API ← «کلیدِ جدید». کلید را در هدرِ Authorization: Bearer chk_… بفرست.

۲) متدها

متد	کار
GET /v1/agents	فهرستِ ایجنت‌ها و کلیدها
POST /v1/run {agent, brief}	شروعِ کار → `job` (برای reel_video، voiceover و carousel هم)
GET /v1/jobs/<job>	وضعیت؛ وقتی `done` شد، `id` و `fmt` فایل را می‌دهد
GET /v1/files/<id>	دانلودِ فایلِ خروجی
GET /v1/runs · GET /v1/wallet	کارهای قبلی · موجودی

۳) مثال

curl -X POST https://ichista.ir/v1/run \
  -H "Authorization: Bearer chk_…" -H "Content-Type: application/json" \
  -d '{"agent":"instagram","brief":"سه پستِ پاییزی برای فروشگاهِ شال"}'

curl https://ichista.ir/v1/jobs/<job> -H "Authorization: Bearer chk_…"
curl -o out.docx https://ichista.ir/v1/files/<id> -H "Authorization: Bearer chk_…"

محدودیت: ۶۰ درخواست در دقیقه برای هر کلید، ۳ کارِ هم‌زمان. بدونِ موجودی، پاسخ 402 است.

۴) ایجنتِ خودت را در نرم‌افزار، سایت یا ربات‌ات صدا بزن

ایجنتی که در چیستا ساخته‌ای — با همان شخصیت، دستورالعمل و دانشِ خودت (فایل‌ها، لیستِ قیمت، سایت) — از هر جا قابلِ صدا زدن است: سایتِ وردپرسی، اپِ موبایل، CRM، n8n/زاپیر، رباتِ روبیکا یا ایتا. شناسهٔ ایجنت (AGENT_ID) را از GET /v1/myagents بگیر.

متد	کار
GET /v1/myagents	ایجنت‌های من (شناسه، نام، پیامِ خوش‌آمد، تعدادِ منابعِ دانش)
POST /v1/myagents/<id>/chat {message, session?}	پاسخِ ایجنت ← `answer` و `sources`. با `session` (مثلاً شناسهٔ مشتری) ایجنت ۱۰ پیامِ آخرِ همان گفتگو را به خاطر می‌سپارد؛ یا خودت `history` بفرست: `[{role:"user"\|"assistant", content}]`
GET /v1/myagents/<id>/knowledge	منابعِ دانش
POST /v1/myagents/<id>/knowledge {title, text} یا {url}	افزودنِ دانش از نرم‌افزارِ خودت (مثلاً لیستِ قیمتِ روزانه)
POST /v1/myagents/<id>/knowledge/remove {id}	حذفِ یک منبع
GET /v1/myagents/<id>/export	بستهٔ ایجنت (ZIP): system_prompt، knowledge.md، agent.json — برای ChatGPT، Claude، Gemini یا هر مدلِ دیگر

curl

curl -X POST https://ichista.ir/v1/myagents/<AGENT_ID>/chat \
  -H "Authorization: Bearer chk_…" -H "Content-Type: application/json" \
  -d '{"message":"ونیر چنده؟","session":"customer-42"}'

# → {"answer":"… ۳ میلیون و ۹۰۰ هزار تومان است. (منبع: tarefe.docx)","sources":["tarefe.docx"],"lead_captured":false,"session":"customer-42"}

JavaScript (Node / مرورگرِ سمتِ سرور)

const r = await fetch("https://ichista.ir/v1/myagents/<AGENT_ID>/chat", {
  method: "POST",
  headers: { "Authorization": "Bearer " + process.env.CHISTA_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ message: userText, session: userId })
});
const { answer, sources } = await r.json();

Python

import os, requests
r = requests.post("https://ichista.ir/v1/myagents/<AGENT_ID>/chat",
    headers={"Authorization": "Bearer " + os.environ["CHISTA_KEY"]},
    json={"message": "ساعت کاری؟", "session": "u-17"}, timeout=60)
print(r.json()["answer"])

کلید را هیچ‌وقت در کدِ سمتِ مرورگر نگذار؛ برای سایت از «یک خط کد» یا وب‌اپِ ایجنت استفاده کن. هزینهٔ هر پیام همان هزینهٔ پیامِ ایجنت است و از کیف پول کم می‌شود. محدودیت: ۶۰ درخواست در دقیقه برای هر کلید.

دربارهٔ ما · تماس با ما · قوانین و شرایطِ استفاده · حریمِ خصوصی · رویهٔ بازگشتِ وجه