Notionʼni AI-agentga ulaymiz

Bitta tayyor prompt — va sizning AI-agentingiz Notionʼda oʻzi sahifalar yaratadi, loyihalarni toʻldiradi, mazmunni oʻqiydi va yangilaydi. Sahifa idʼlarini nusxalashsiz, dasturlashsiz. Notion API bilan ishlay oladigan har qanday AI-agentga toʻgʻri keladi.

Nima chiqadi

Agent quyidagilarni qila oladi:

• Sahifalaringizni nomi boʻyicha oʻzi topadi (id raqamlarini nusxalash shart emas)
• Istalgan strukturali sahifa va loyihalar yaratadi (sarlavhalar, roʻyxatlar, chek-listlar, iqtiboslar, calloutʼlar, kod)
• Ishlar davomida mazmunni toʻldiradi va yangilaydi
• Mavjud sahifalarni oʻqiydi va ularning mazmuni bilan ishlaydi
• Maʼlumotlar bazalarini boshqaradi (yozuvlar, holatlar, filtrlar)
• Sizning strukturangni eslab qoladi (nimani qayerga qoʻyish)

Telegramʼda «Eslatmalarga X haqida gʻoyani uchta band bilan tashla» deb yozasiz — agent sahifa yaratadi. «Y loyihasini yangila, 20.06 deadline haqida blok qoʻshing» deb yozasiz — qoʻshadi.

3 qadamda oʻrnatish

1-qadam. Notionʼda Internal Connection yarating

Bu «integratsiya», u orqali agent sizning ish maydoningizga ulanadi.

1. notion.so/profile/integrations/internal'ni oching
2. Plyusli Create a new connection kartochkasini bosing
3. Formani toʻldiring:
   • Connection name — istalgan nom, masalan Mening AI-agentim
   • Icon — oʻtkazib yuboring yoki 512×512 rasm yukla
   • Associated workspace — sahifalaring yotgan workspaceʼni tanlang. Muhim: yaratilgandan keyin oʻzgartirib boʻlmaydi
4. Create'ni bosing
5. Integration successfully created modalkasida Configure integration settings'ni bosing
6. Configuration tabida Installation access token maydonini toping, Show'ni bosing → kalitni nusxalang (ntn_... yoki secret_... bilan boshlanadi)

Oʻsha Configuration tabida Capabilities blokini tekshiring — Read / Update / Insert content belgilari qoʻyilgan boʻlishi kerak (standart boʻyicha ular yoqilgan).

2-qadam. Sahifalarni integratsiya bilan ulash (share)

Standart boʻyicha integratsiya hech narsani koʻrmaydi. Unga ruxsat berish kerak.

Boshlash uchun eng yaxshi variant — bitta umumiy ildiz sahifa yarating, masalan AI-yordamchi yoki Loyihalar, va integratsiyani faqat unga ulang. Shunda agent barcha materialni shu sahifa ichida yaratadi, siz esa unga ortiqcha ruxsat bermaysiz.

Ulashning ikki usuli:

A usul — Notion sahifasidan (1-2 sahifa uchun osonroq):

• Kerakli sahifani oching
• Yuqori oʻngda: • • • → Connections → oʻz integratsiyangni tanlang

B usul — integratsiya sahifasidan (bir nechta sahifa uchun qulay):

• Edit connection sahifasida Content access tabini oching
• Edit access'ni bosing → Manage page access modalkasi ochiladi
• Sahifalarni tanlang → Save

3-qadam. Agentga kalit + quyidagi promptni bering

Hech qanday sahifa idʼlarini nusxalash kerak emas. Shunchaki agentga kalitni va quyidagi promptni toʻliq yuboring. NOTION_KEYni oʻz kalitingizga almashtir:

Mening Notionʼimni ula va sahifalarni boshqarishni oʻrganing.
Mening integratsiya kalitim: NOTION_KEY

Asosiy qoida: siz mendan sahifa idʼlarini SOʻRAMAYSIZ.
Siz ularni Notion API search orqali oʻzingiz topasiz va eslab qolasiz,
keyingi soʻrovlarda qaytadan qidirmaslik uchun.

1. BIRINCHI ISHGA TUSHISH — menga nima ochiqligini toping

Quyidagi soʻrovni yuboring:
POST https://api.notion.com/v1/search
Headers:
  Authorization: Bearer NOTION_KEY
  Notion-Version: 2022-06-28
  Content-Type: application/json
Body: {"filter": {"property": "object", "value": "page"}}

Javobda integratsiya koʻradigan barcha sahifalar boʻladi. Menga ularning
nomlari roʻyxatini koʻrsat, qaysilari ildiz (yangi sahifalar uchun ota
boʻlishi mumkin) ekanini belgila, va yaratilganlarni standart boʻyicha
qayerga saqlashni xohlashimni soʻrang.

2. Mening tanlovimni ESLAB QOL

Mening javobimdan keyin xotirangda saqlang:
- PARENT_PAGE_ID = men ota sifatida tanlagan sahifaning idʼsi
- Boshqa sahifalarim uchun "nom → id" xaritasi,
  «X sahifani yangila» boʻlganda darrov uning idʼsini bilish uchun.

3. SAHIFA YARATISH — men «X sahifa yarat» deganda

Agar qayerga ekanini koʻrsatmagan boʻlsam — PARENT_PAGE_ID ostiga qoʻying.
Agar «Xʼni Y ichida yarat» desam — Yʼni search orqali toping, uning
idʼsini ota sifatida ishlat, va eslab qol.

POST https://api.notion.com/v1/pages
Body:
{
  "parent": {"page_id": "PARENT_OR_FOUND_ID"},
  "properties": {"title": {"title": [{"text": {"content": "X"}}]}},
  "children": [... kontent bloklari ...]
}

Bazaviy blok turlari (children):
- paragraph: {"type":"paragraph","paragraph":{"rich_text":[{"type":"text","text":{"content":"matn"}}]}}
- heading_1 / heading_2 / heading_3: shunga oʻxshash
- bulleted_list_item, numbered_list_item, to_do, callout, quote, divider, code — xuddi shu sxema boʻyicha

4. YANGILASH — men «X sahifani yangila» deganda

Agar Xʼning idʼsi sizda xaritada allaqachon boʻlsa — darrov ishlat.
Agar yoʻq boʻlsa — search orqali toping (titleʼni queryʼga uzating), eslab qol, ishlat.

PATCH https://api.notion.com/v1/blocks/PAGE_ID/children
  — sahifa oxiriga yangi bloklar qoʻshish (body: {"children": [...]})
PATCH https://api.notion.com/v1/blocks/BLOCK_ID
  — alohida blokni yangilash
DELETE https://api.notion.com/v1/blocks/BLOCK_ID
  — alohida blokni oʻchirish (arxivlash)
PATCH https://api.notion.com/v1/pages/PAGE_ID
  body: {"archived": true}
  — sahifani butunlay arxivlash

5. OʻQISH — men «X sahifani oʻqing» deganda

GET https://api.notion.com/v1/blocks/PAGE_ID/children?page_size=100

6. XATOLARNI QAYTA ISHLASH

- "object_not_found" → sahifa integratsiyaga ulanmagan.
  Menga qaysi sahifani Connections orqali ulashni ayting.
- "unauthorized" → kalit notoʻgʻri yoki bekor qilingan. Menga
  kalitni qayta tekshirishni ayting.

7. TASDIQLASHLAR

Har bir yaratish/yangilashdan keyin sahifaga havola yuboring,
men darrov tekshira olishim uchun.

TAYYORLIK TESTI
Hozir aynan search qiling, menga mavjud sahifalar roʻyxatini koʻrsat
va yangi sahifalar uchun qaysi birini ildiz sifatida ishlatishni soʻrang.

Agentning kutilgan javobi: mavjud sahifalar roʻyxati va qaysi birini asosiy sahifa qilish haqidagi savol. Tanlovingizdan keyin agent uni eslab qoladi va id raqamini qayta soʻramaydi.

Ulagandan keyin nimani sinab koʻrish

«Kontent uchun gʻoyalar» sahifasini uchta boʻlim bilan yarat:
Reels, Telegramʼdagi postlar, video. Har bir boʻlim ostida
5 ta boʻsh bandli chek-list qiling.

Menga lidlar uchun CRM-jadval yarat, ustunlar bilan: ism, manba,
holat (yangi / uchrashuv / bitim / rad etish), eslatmalar.

«X loyiha» sahifasini yangila, «Deadlineʼlar» boʻlimini qoʻshing
uchta band bilan: PRD 25-maygacha, MVP 10-iyungacha, reliz 30-iyungacha.

«Uchrashuv eslatmalari 2026-05-20» sahifasini oʻqing va
qisqacha mazmunini chiqaring.

Agar biror narsa notoʻgʻri ketsa

Agent sahifa idʼsini soʻrayapti

Promptni eʼtiborsiz qoldiryapti. Eslat: «search orqali toping va oʻzingiz eslab qol, men id uzatmayman». Agar oʻjarlik qilsa — search APIʼni biladigan agentga almashtir (Claude va ChatGPT biladi).

object_not_found xatosi

Sahifa integratsiya bilan ulanmagan (share qilinmagan). Sahifani oching → • • • → Connections → integratsiyani ula. Yoki 2-qadamdan B usul bilan qiling.

unauthorized xatosi

Kalit notoʻgʻri. Toʻliq, probelsiz nusxalaganingizni tekshiring. Configuration tabida agar eski kalit oqib ketgan yoki unutgan boʻlsangiz yangi kalit uchun Refresh'ni bosing.

Search boʻsh roʻyxat qaytaryapti

Integratsiya hech bir sahifa bilan bogʻlanmagan. 2-qadamga qayt.

Notion API limitlari — sekundiga taxminan 3 ta soʻrov. Shaxsiy vazifalar uchun hech qachon urilmaysiz.

Hozirgi bitta maslahat

Agentga butun ish maydoniga kirish huquqini darrov bermang. «Agent qum qutisi» (Sandbox) uchun alohida sahifa yarating va integratsiyani faqat unga ulang. Tizimga ishonch hosil qilganingizdan keyin ruxsatni kengaytiring. Bu minimal imtiyozlar tamoyilidir.

Keyin nima

Sahifalar bilan bazaviy ish joyiga tushganda, Notion maʼlumotlar bazalarini (taskboardʼlar, CRM, kontent-rejalar) ulash mumkin — bu allaqachon toʻyinganroq stsenariy, agent yozuvlar yaratadi va holatlarni oʻzgartiradi. Bu haqida — alohida qoʻllanmada, yoki agentdan soʻrang: «Notionʼdagi databaselarim bilan qanday ishlashni aytib bering, ulardan birida koʻrsat».

Qoʻshni qoʻllanmalar:

• AGENTS.md va Memory Bank — xotira poydevori, usiz har qanday integratsiya boʻsh yurishda ishlaydi
• Token tejash — agent Notionʼga tez-tez borganda obunani yoqib yubormaslik uchun