Chatbot eszközök

Áttekintés

A Chatbot eszköz kategória mindent lefed, ami a Yaplet AI chatbot rendszeréhez kapcsolódik. Létrehozhatsz chatbotokat, tudást adhatsz nekik dokumentumokon keresztül, finomhangolhatod a viselkedésüket, és kivizsgálhatod, amikor helytelen vagy váratlan válaszokat adnak.

manage_chatbot

Létrehoz egy új AI chatbotot vagy frissíti egy meglévő beállításait.

Paraméterek

Hogyan működik

Chatbot létrehozása:

• Csak a name kötelező. A chatbot ésszerű alapértelmezésekkel jön létre:
  • Típus: AI
  • Kontextus nélküli viselkedés: decline (udvariasan elutasítja az ismeretlen kérdéseket)
  • Ügyintéző átadás: engedélyezve, 6 üzenetes küszöb
  • Újrarangsorolás: engedélyezve (intelligens válaszillesztés)
  • PII maszkolás: letiltva
• A chatbot alapértelmezetten inaktívként indul. Állítsd active: true-ra az azonnali engedélyezéshez.

Chatbot frissítése:

• Add meg az id-t és csak azokat a mezőket, amelyeket változtatni szeretnél.
• A noContextBehavior beállítás kritikus az AI minőség szempontjából:
  • "decline" — Legbiztonságosabb opció. Az AI udvariasan közli, hogy nincs információja az adott témáról.
  • "request_agent" — Az AI emberi ügyintézőnek adja át, ha nem talál választ.
  • "answer" — Az AI általános tudást használva próbál válaszolni. Ez pontatlan válaszokat eredményezhet, és általában nem ajánlott.

Példa promptok

• Hozz létre egy Support Bot nevű chatbotot.
• Hozz létre egy Sales Assistant nevű chatbotot és aktiváld azonnal.
• Aktiváld a Support Bot chatbotomat.
• Állítsd be a chatbotomat, hogy 3 megválaszolatlan üzenet után emberi ügyintézőnek adja át.
• Változtasd a kontextus nélküli viselkedést elutasításra a találgatás helyett.
• Tiltsd le az ügyintéző átadást a chatbotomon.
• Állítsd be az ügyintéző átadási üzenetet erre: Hadd kapcsoljalak össze egy szupport specialistával.

manage_chatbot_document

Szöveges dokumentumot hoz létre vagy frissít a chatbot tudásbázisában. A dokumentumok automatikusan feldolgozásra kerülnek, hogy az AI használhassa őket a kérdések megválaszolásához.

Paraméterek

Hogyan működik

Dokumentum létrehozása:

• Add meg a chatbotId-t, name-et és content-et.
• A tartalom automatikusan feldolgozásra és indexelésre kerül, hogy a chatbot lekérhesse, amikor kérdésekre válaszol.
• Az indexelés után a chatbot azonnal felhasználhatja ezt a tudást a látogatói kérdések megválaszolásához.

Dokumentum frissítése:

• Add meg az id-t és a változtatni kívánt mezőket (name és/vagy content).
• Frissítéskor az AI index újraépül az új tartalomból.
• Ez azt jelenti, hogy a változtatások azonnal érvénybe lépnek — a chatbot rögtön a frissített tudást használja.

Példa promptok

• Adj hozzá egy dokumentumot a chatbotomhoz a visszatérítési szabályzatunkról: az ügyfelek 30 napon belül teljes visszatérítést kaphatnak.
• Hozz létre egy tudásdokumentumot a Sales Bot-nak az árszintjeinkről.
• Frissítsd a szállítási szabályzat dokumentumot az új nemzetközi szállítási díjakkal.
• Nevezd át az GyIK dokumentumot erre: Gyakran Ismételt Kérdések - 2026.
• Adj hozzá egy dokumentumot a chatbotomhoz ezekről a témákról: fiók beállítás, jelszó visszaállítás és számlázási kérdések.
• Javítsd a chatbot tudáshiányát — adj hozzá egy dokumentumot a visszaküldési folyamatunkról. (jellemzően egy diagnosztikai lépés után)

diagnose_ai_response

Elemzi, hogy egy AI chatbot miért adott egy konkrét választ. Részletes diagnosztikai jelentést ad vissza a feltett kérdéssel, a kapott válasszal, a használt tudás kontextussal, chatbot beállításokkal és megvalósítható javaslatokkal.

Paraméterek

Hogyan működik

1. Megtalálja az AI interakciót, amely az üzenethez kapcsolódik — beleértve a látogató kérdését, az AI válaszát, a lekért tudást és a használt modellt.
2. Osztályozza az eredményt — A válasz releváns tudáson alapult? Az AI-nak hiányzott a kontextus? A látogató emberi ügyintézőhöz lett átirányítva? Technikai hiba történt?
3. Ellenőrzi a chatbot beállításokat, amelyek hozzájárulhattak a problémához (kontextus nélküli viselkedés, egyedi utasítások, tudáslekérési beállítások).
4. Megvalósítható javaslatokat ad — általában azt javasolva, hogy adj hozzá egy tudásdokumentumot a hiány pótlásához, vagy módosítsd a chatbot beállításait.

Hogyan kapd meg az üzenet azonosítót

Használd a get_conversation_messages-t a beszélgetés üzeneteinek olvasásához. Az AI chatbot válaszok egyértelműen meg vannak jelölve az eredményekben. Az AI válasz üzenet id-ja az, amit a diagnose_ai_response-nak átadsz.

Példa promptok

• A chatbot rossz választ adott az X beszélgetésben. Ki tudod diagnosztizálni, mi történt? (először olvassa az üzeneteket, megtalálja az AI választ, majd diagnosztizál)
• Miért nem tudott válaszolni az AI chatbot az ügyfél árazással kapcsolatos kérdésére?
• Diagnosztizáld az AI választ arra az üzenetre, ahol a chatbot a szállításról beszélt.
• Ellenőrizd, miért eszkalálta a chatbot emberi ügyintézőhöz a legutóbbi beszélgetésben.
• A chatbot valami helytelen dolgot mondott — diagnosztizáld és javítsd a tudásbázist. (diagnosztizál, azonosítja a hiányt, majd a manage_chatbot_document-tel hozzáadja a hiányzó információt)

Általános munkafolyamat minták

Teljes chatbot beállítás

1. Chatbot létrehozása → manage_chatbot
2. Tudásdokumentumok hozzáadása → manage_chatbot_document (ismételd meg minden témánál)
3. Widgethez kapcsolás → link_to_widget (a Widget eszközökből)
4. Aktiválás → manage_chatbot az active: true beállítással

Példa prompt: Hozz létre egy Support Bot nevű chatbotot, adj hozzá dokumentumokat a visszatérítési szabályzatunkról és szállítási információkról, kapcsold az alapértelmezett widgetemhez, és aktiváld.

Diagnosztizálás és javítás

1. Beszélgetés megkeresése → search_conversations vagy list_records
2. Üzenetek olvasása → get_conversation_messages
3. AI válasz diagnosztizálása → diagnose_ai_response
4. Tudáshiány pótlása → manage_chatbot_document

Példa prompt: Keress beszélgetéseket, ahol a chatbot nem tudott válaszolni, diagnosztizáld a legutóbbit, és adj hozzá egy dokumentumot a probléma megoldásához.