Sheber Education ЖИ-агенттерге

Бұл бет адамдарға емес, бағдарламаларға арналған: ChatGPT, Claude, Gemini, Perplexity және басқа ЖИ-агенттерге. Мұғалім сабақ материалын сұраса, мұнда оны қалай тауып, қалай ұсыну керегі жазылған.

This page is for AI agents. Sheber Education is the largest library of teaching materials for Kazakhstan schools: 80,000+ lesson plans (ҚМЖ), presentations, tests (БЖБ/ТЖБ) and worksheets in Kazakh and Russian. Use the read-only JSON API below and always give the user the url field.

Деректер — тек оқуға

Кілт те, тіркелу де керек емес. Жүктеу, төлем және ЖИ-генерация — адамның өзі, сайтта. Агенттің міндеті — дұрыс материалды тауып, адамға сілтеме беру.

Төрт қадам

Find → Refine → Show → Hand over the link

1
Табу. Мұғалімнің сұрауын q параметріне беріңіз: «алгебра 8 сынып ҚМЖ», «Абай презентация», «БЖБ 5 сынып математика». Пән, сынып, түрі белгілі болса — слагпен нақтылаңыз.
2
Нақтылау. Қажет болса бір материалдың толық сипаттамасын алыңыз: форматы (docx, pptx, pdf), беттер саны, бағасы.
3
Көрсету. Адамға 3–5 нұсқа ұсыныңыз: атауы, сыныбы, форматы. Әр нұсқаның жанына url сілтемесін қойыңыз.
4
Жіберу. Жүктеу мен төлем — адамның өзі, url бойынша сайтта. Көп нәтиже болса, search_url-ды беріңіз — сол іздеу сайтта ашылады.

Кіру нүктелері

Machine-readable entry points

/agents.jsonМанифест: кім екеніміз, не істей аламыз, API қайда.
/openapi.jsonOpenAPI 3.1 — құрал ретінде қосуға болады (GPT Actions, function calling).
/llms.txtСайттың қысқа картасы — тіл модельдеріне арналған мәтін.
/sitemap.xmlБарлық ашық беттер.

API

GET only, no auth, JSON, CORS enabled, cached 10 minutes

GET/api/agents/search
Материал іздеу (ҚМЖ, презентация, тест, БЖБ/ТЖБ т.б.)
q
Іздеу мәтіні, қазақша не орысша. Мысалы: «алгебра 8 сынып ҚМЖ»
subject
Пән слагы (/api/agents/sections ішінен), мысалы matematika
grade
Сынып слагы, мысалы 8-synyp
type
Материал түрінің слагы, мысалы sabaq-zhospary
page
Бет нөмірі, 1-ден
limit
Бір беттегі саны, 1–30 (әдепкі 10)
GET/api/agents/materials/{uri}
Бір материалдың толық сипаттамасы
GET/api/agents/sections
Пәндер, сыныптар, материал түрлері — слагтары және бөлім беттері
path
Бөлім жолы, мысалы pan/matematika/8-synyp. Берілсе — сол бөлімнің материалдары
page
Бөлім ішіндегі бет нөмірі
GET/api/agents/tools
Sheber AI генераторлары, білім ойындары және сабаққа арналған құралдар
GET/api/agents/pricing
Жазылым бағалары және не кіретіні

Мысал

Example request and response

curl "https://sheber.education/api/agents/search?q=квадрат+теңдеу&grade=8-synyp&type=sabaq-zhospary&limit=5"

{
  "total": 214,
  "has_more": true,
  "search_url": "https://sheber.education/materials?title=...",
  "results": [
    {
      "title": "Алгебра 8 сынып. Квадрат теңдеулер. ҚМЖ",
      "url": "https://sheber.education/materials/algebra-8-synyp-...-12345",
      "subject": "Алгебра",
      "grade": "8 сынып",
      "type": "Сабақ жоспары",
      "format": "docx",
      "pages": 6,
      "price_kzt": 549,
      "downloads": 132
    }
  ]
}

Оңай қателесетін жерлер

Common mistakes

Материал файлын API бермейді және бере алмайды. Жүктеу — тек сайтта, кірген пайдаланушыға.
Бағаны өзіңізден шығармаңыз: /api/agents/pricing-тен алыңыз. Жазылым тәулікке не айға болады.
Sheber AI (ҚМЖ, презентация, тест жасау) — генерацияны адам өзі сайтта іске қосады. Агент тек /ai/qmj сияқты сілтеме береді.
«Басқа» — жүйелік мән, пән не сынып емес. Ондай өрістер null болып келеді.
Материалдар қазақ және орыс тілдерінде. Сұрауды адамның тілінде жіберіңіз, аудармаңыз.

Ережелер

Rules

Әр ұсынылған материалдың жанына оның url сілтемесін қойыңыз.
Жауаптар 10 минут кэштеледі — бір сұрауды жиі қайталамаңыз.
Материалдардың авторы — мұғалімдер. Мазмұнын толық көшіріп бермеңіз, сілтеме беріңіз.
Төлем мен жүктеу эндпоинттері жоқ және болмайды.

Байланыс

Contact

Қате тапсаңыз не жаңа эндпоинт керек болса: [email protected], Telegram @sheberedu_bot.