Adathozzáférési eszközök

Áttekintés

Az adathozzáférési eszközök minden munkafolyamat alapját képezik. Mielőtt frissíthetnél egy widgetet, szerkeszthetnél egy chatbotot vagy ellenőrizhetnéd a kampány statisztikákat, általában először meg kell találnod az erőforrást. Ez a két eszköz csak olvasási hozzáférést biztosít a szervezeted minden erőforrás típusához.

Szükséges jogosultság:Copilot.DataAccess

list_records

Listázza egy adott erőforrás típus rekordjait a szervezetedben. Minden rekordhoz összefoglaló nézetet ad vissza (nem teljes részleteket — arra a get_record való).

Paraméterek

Paraméter	Típus	Kötelező	Leírás
`table`	string	Igen	A listázni kívánt erőforrás típusa. Lásd az elérhető típusokat alább.
`limit`	number	Nem	Hány rekordot adjon vissza. Alapértelmezés: 50, max: 300.
`from`	number	Nem	Lapozási eltolás (csak beszélgetéseknél). Alapértelmezés: 0.
`chatbotId`	string	Feltételes	Szükséges chatbot dokumentumok vagy beszélgetésindítók listázásához.
`knowledgebaseId`	string	Feltételes	Szükséges KB cikkek vagy kategóriák listázásához.
`documentationId`	string	Feltételes	Szükséges dokumentáció kategóriák vagy oldalak listázásához.
`category`	string	Nem	Szűrő a beszélgetéseknél: `"all"`, `"my-inbox"`, vagy `"unassigned"`.
`publishedOnly`	boolean	Nem	Szűrő cikkekhez és dokumentációs oldalakhoz — csak közzétett elemeket ad vissza.

Elérhető erőforrás típusok

Típus	Mit listáz
`widgets`	Chat widgetek
`chatbots`	AI chatbotok
`knowledgebase`	Tudásbázisok
`chats`	Beszélgetések
`visitors`	Weboldal látogatók
`documents`	Chatbot tudás dokumentumok (`chatbotId` szükséges)
`conversation_starters`	Chatbot beszélgetésindítók (`chatbotId` szükséges)
`articles`	KB cikkek (`knowledgebaseId` szükséges)
`categories`	KB kategóriák (`knowledgebaseId` szükséges)
`documentation`	Dokumentációs portálok
`doc_categories`	Dokumentáció kategóriák (`documentationId` szükséges)
`doc_pages`	Dokumentációs oldalak (`documentationId` szükséges)
`contact_groups`	Névjegycsoportok feliratkozó számokkal
`contact_segments`	Névjegy szegmensek
`email_templates`	E-mail sablonok
`campaigns`	E-mail kampányok
`subscribers`	Hírlevél feliratkozók
`outreach`	Összes elérési terjesztési elem (szalagcímek, üzenetek, felmérések, bemutatók, hírek)

Hogyan működik

A rekordok létrehozási dátum szerint rendezve kerülnek visszaadásra (legújabb először), kivéve a beszélgetéseket, amelyek az utolsó frissítés szerint rendeznek.
Az outreach típus az összes elérési terjesztési elemet altípusonként csoportosítva adja vissza (szalagcímek, üzenetek, felmérések, bemutatók, hírek).
A lapozás csak a from paraméterrel a beszélgetéseknél támogatott. A többi típusnál egyszerűen a limit paraméter kerül alkalmazásra.

Példa promptok

„Mutasd meg az összes widgetemet."
„Listázd a chatbotjaimat."
„Jelenleg milyen hozzá nem rendelt beszélgetések vannak?"
„Mutasd meg a Szupport Bot chatbotomban lévő dokumentumokat." (először megtalálja a chatbotot, majd listázza a dokumentumokat)
„Listázd az összes közzétett cikket a Súgó Központ tudásbázisomban." (megtalálja a KB-t, majd publishedOnly: true-val listázza a cikkeket)
„Mutasd meg a hírlevél névjegycsoportjaimat és az egyes csoportok feliratkozóinak számát."
„Milyen kampányokat küldtem nemrég?"
„Listázd az összes elérési terjesztési elemet — szalagcímeket, felméréseket, bemutatókat, mindent."
„Mutasd meg a legutóbbi 100 beszélgetésemet."

get_record

Egyes rekordot kér le azonosító szerint teljes részletekkel. Több információt ad vissza, mint a list_records — például teljes konfigurációs objektumokat, tartalom mezőket és kapcsolódó adatokat.

Paraméterek

Paraméter	Típus	Kötelező	Leírás
`table`	string	Igen	Az erőforrás típusa. Lásd az elérhető táblákat alább.
`id`	string	Igen	A lekérendő rekord egyedi azonosítója.

Elérhető erőforrás típusok

Ugyanazok a típusok, mint a list_records-nál, és ezenkívül az egyedi elemek lekéréséhez meghatározott elérési terjesztés altípusok:

Típus	Mit kapsz
`widgets`	Teljes konfiguráció, téma színek és kapcsolt erőforrások
`chatbots`	Teljes AI beállítások és konfiguráció
`knowledgebase`	Portál részletek kategóriákkal
`documentation`	Portál részletek kategóriákkal
`doc_categories`	Kategória részletek, beleértve a leírást és közzétett státuszt
`doc_pages`	Teljes Markdown tartalom és oldal hierarchia
`chats`	Teljes beszélgetési részletek
`visitors`	Teljes látogató profil
`documents`	Teljes dokumentum tartalom
`conversation_starters`	Indító felirat és prompt
`articles`	Teljes HTML tartalom
`categories`	Kategória részletek és hierarchia
`campaigns`	Teljes kampány részletek, beleértve az e-mail tartalmat és címzetteket
`subscribers`	Feliratkozó profil és státusz
`email_templates`	Teljes sablon tartalom
`banners`	Tartalom, stílus és aktiválási szabályok
`messages`	Tartalom és aktiválási szabályok
`surveys`	Felmérési folyamat és aktiválási szabályok
`tours`	Bemutató lépések és aktiválási szabályok
`news`	Teljes tartalom, borítókép és nyelv

Megjegyzés: Az elérési terjesztésnél használd a specifikus típus nevet (banners, messages, surveys, tours, news) — nem az összesített outreach típust, amelyet a list_records használ.

Hogyan működik

A rekordnak a szervezetedhez kell tartoznia. Más szervezetek rekordjaihoz való hozzáférési kísérletek sikertelenek lesznek.
Az erőforrás teljes részleteit adja vissza, teljes képet adva a konfigurációjáról és tartalmáról.

Példa promptok

„Mutasd meg az alapértelmezett widgetem teljes részleteit." (először listázza a widgeteket, majd lekéri az alapértelmezettet)
„Mi az AI konfiguráció a Szupport Botomon?" (listázza a chatbotokat, majd lekéri az adott egyet)
„Mutasd meg a visszatérítési szabályzat dokumentum tartalmát." (listázza a dokumentumokat, majd lekéri a teljes tartalmat)
„Hadd lássam az Első lépések cikk teljes HTML-jét." (megtalálja a cikket, majd lekéri a tartalmát)
„Mik az aktiválási szabályok az akciós szalagcímemen?" (listázza az elérési terjesztési elemeket, majd lekéri a szalagcím részleteit)
„Mutasd meg a márciusi kampány e-mail tartalmát és címzettjeit." (lekéri a kampányt teljes küldési részletekkel)

Általános munkafolyamat minták

Felfedezés majd cselekvés

A legtöbb munkafolyamat adathozzáférési eszközökkel kezdődik:

Listázd az erőforrásokat, hogy megtudd, mi létezik → list_records
Vizsgáld meg az adott erőforrást az állapotának megértéséhez → get_record
Módosítsd a megfelelő kezelő eszközzel → manage_widget, manage_chatbot stb.

Tömeges áttekintés

Használd a list_records-t magasabb limit-tel egyszerre sok erőforrás áttekintéséhez:

„Mutasd meg mind a 200 hírlevél névjegyemet."
„Listázd az utolsó 100 beszélgetésemet."

Kereszthivatkozás

Kombináld a különböző táblákból való listázást a kapcsolatok megértéséhez:

„Listázd a widgetjeimet és chatbotjaimat, majd mondd meg, melyik chatbot melyik widgethez van kapcsolva."
„Mutasd meg az összes tudásbázisomat és cikkeik számát."