Resept: AI agentdən cavab almaq, bilik bazası və öz botunuz

Son yeniləmə: 11 noyabr 2026 · 5 dəq oxunur

Addımlar

1. 1

   Nə alırsınız

   • Saytınızdakı axtarış və ya köməkçi Clomni AI agentinin təlimatları və bilik bazası ilə cavab verir.
   • Sayt dəyişəndə AI agent yeni məlumatla cavab verir, bilik bazasını əl ilə yeniləmək lazım olmur.
   • Öz botunuz (məsələn öz LLM-iniz) WhatsApp, Instagram, çat söhbətlərinə cavab yazır, bacarmayanda operatora verir.
2. 2

   A. AI agentdən öz platformanızda cavab almaq

   Scope-lar: ai_agents:read (aşağı risk) agentin id-sini tapmaq üçün, ai_agents:ask (orta risk) sual vermək üçün.

   Agentləri siyahılayın:

   curl "https://api.clomni.ai/v1/ai_agents" \
     -H "Authorization: Bearer clomni_pat_xxx"

   Sual verin. Söhbətin davamıdırsa, əvvəlki sual və cavabları history-də göndərin: Clomni sizin söhbətinizi saxlamır.

   curl -X POST "https://api.clomni.ai/v1/ai_agents/4/ask" \
     -H "Authorization: Bearer clomni_pat_xxx" \
     -H "Content-Type: application/json" \
     -d '{"question": "Bəs regionlara?", "history": [{"role": "user", "content": "Çatdırılma neçə günə olur?"}, {"role": "assistant", "content": "Bakı daxilində 1 iş günü."}]}'

   { "answer": "Regionlara sifariş 2-3 iş günündə çatdırılır.", "handoff": false, "sources": [] }

   • question ən çox 4000 simvoldur, history-dən son 20 mesaj nəzərə alınır. Boş və ya çox uzun sual 400 invalid_request qaytarır, agent tapılmasa 404 not_found.
   • handoff: true olanda agent özü cavab verə bilmir və answer null-dur: sualı insana verin.
   • sources hazırda həmişə boş siyahıdır.
   • Heç bir söhbətə heç nə yazılmır: ask cavabı yalnız sizə qaytarır.
   • Hər cavab workspace-in AI kreditindən çıxılır. Kredit bitəndə 402 ai_credit_spent gəlir. Qalan krediti GET /v1/ai_credits göstərir (billing:read).
3. 3

   B. Bilik bazasını sisteminizdən yeniləmək

   Scope-lar: knowledge:write (orta risk), agentin id-si üçün ai_agents:read. FAQ yazacaqsınızsa, ai_agents:train (orta risk).

   Saytınızdakı səhifəni linklə əlavə edin:

   curl -X POST "https://api.clomni.ai/v1/knowledge" \
     -H "Authorization: Bearer clomni_pat_xxx" \
     -H "Content-Type: application/json" \
     -d '{"document": {"name": "Çatdırılma qaydaları", "external_link": "https://demo-store.example/delivery", "assistant_id": 4}}'

   Sənəd fonda oxunur, bir neçə dəqiqə çəkə bilər. Hazır olub-olmadığını GET /v1/knowledge?assistant_id=4 cavabındakı status göstərir. Ayrıca yeniləmə endpoint-i yoxdur: səhifə dəyişəndə köhnə sənədi DELETE /v1/knowledge/{document_id} ilə silib yenisini əlavə edin.

   Qısa sual-cavab üçün FAQ yazın:

   curl -X POST "https://api.clomni.ai/v1/ai_agent_faqs" \
     -H "Authorization: Bearer clomni_pat_xxx" \
     -H "Content-Type: application/json" \
     -d '{"question": "Çatdırılma neçə günə olur?", "answer": "Bakı daxilində 1 iş günü, regionlara 2-3 iş günü.", "assistant_id": 4}'

   Agentin ayarlarını və təlimatlarını kodla dəyişmək iki addımdır: ai_agents:write qaralamanı dəyişir (PATCH /v1/ai_agents/{ai_agent_id}/draft), ai_agents:publish onu canlı edir (POST /v1/ai_agents/{ai_agent_id}/draft/publish). ai_agents:publish yüksək riskdir, çünki müştəriyə gedən cavabları dəyişir.

4. 4

   C. Öz AI botunuzu söhbətlərə qoşmaq

   Scope-lar: messages:read (orta) yeni mesajı almaq üçün, messages:send (yüksək) cavab yazmaq üçün, conversations:assign (orta) operatora vermək üçün. Statusu dəyişəcəksinizsə conversations:write (orta), operatora qeyd buraxacaqsınızsa notes:write (aşağı).

   Kod yazmadan, yalnız webhook ünvanı ilə də bot qoşmaq olar: Öz botunuzu kanala qoşmaq (agent botu). Aşağıdakı yol developer app ilə işləyir.

   1. Developer portalında app-ın webhook-unda message.created mövzusunu seçin.
   2. Gələn hadisədə yalnız müştərinin mesajına cavab verin: data.direction incoming, data.sender.type contact olmalıdır. message.created sizin öz cavabınız və daxili qeydlər üçün də gəlir: onlara cavab versəniz, bot özü ilə danışar.
   3. Cavabı söhbətə yazın. Yolda data.conversation_number (paneldəki nömrə) işlədin, data.conversation_id yox: sonuncu daxili ID-dir.

   curl -X POST "https://api.clomni.ai/v1/conversations/1042/messages" \
     -H "Authorization: Bearer clomni_pat_xxx" \
     -H "Idempotency-Key: 6f1c2a9e-3b7d-4f0a-9c55-0e8b1d2a7f41" \
     -H "Content-Type: application/json" \
     -d '{"content": "Sifarişiniz sabah çatdırılacaq."}'

   4. Bot bacarmayanda söhbəti komandaya və ya operatora verin:

   curl -X POST "https://api.clomni.ai/v1/conversations/1042/assignments" \
     -H "Authorization: Bearer clomni_pat_xxx" \
     -H "Content-Type: application/json" \
     -d '{"team_id": 3}'

   5. İstəsəniz, bot danışarkən söhbəti pending saxlayın və operatora verəndə open edin (POST /v1/conversations/{conversation_id}/toggle_status, conversations:write). Clomni-nin AI agenti və axınları da söhbəti pending saxlayır, pending söhbət «Açıq» siyahısına düşmür.

   API ilə göndərilən mesaj tokenin sahibinin adı ilə görünür (daxili app-da app-ı yaradan istifadəçi). Botun cavabları ayrıca adla görünsün istəyirsinizsə, app-ı bot üçün ayrıca administrator istifadəçidən yaradın. POST /v1/conversations/{conversation_id}/messages token üzrə dəqiqədə 60 sorğu ilə məhdudlaşır.

5. 5

   Tez-tez səhvlər

   • 402 ai_credit_spent avtomatik təkrar edilir. Kredit artırılana qədər gözləyin.
   • handoff: true olanda da istifadəçiyə nəsə göstərilir. Sualı insana verin.
   • Suala kart nömrəsi, parol kimi şəxsi məlumat yazılır. Yazmayın.
   • Qiymət, tarix, sifariş nömrəsi kimi dəqiq məlumat yoxlanmadan göstərilir. Öz sisteminizdən təsdiqləyin.
   • Sənəd əlavə olunan kimi agentdən yeni cavab gözlənilir. Əvvəl status hazır olmalıdır.
   • Bot webhook-dakı conversation_id-ni yolda işlədir və 404 alır və ya başqa söhbətə yazır. conversation_number işlədin.
   • Bot öz mesajına cavab verir və dövrə yaranır. Yalnız incoming mesajlara cavab verin.
   • Webhook təkrar gəlir və bot iki dəfə cavab yazır. Hadisəni id ilə yoxlayın, göndərişdə Idempotency-Key işlədin.

   Bütün AI endpoint-ləri: Scope-lar və endpoint-lər: AI agentlər, bilik bazası, kömək mərkəzi.