MaviBot командасы әзірлеген арнайы функцияны пайдалана отырып, сіздің AI чат-ботыңыз Google Sheet-тен мәндерді интеллектуалды түрде оқып, оларды жоба параметрлеріндегі жүйелік айнымалыға сақтай алады. Бұл сіздің көмекшіңіз үшін синхрондалған, динамикалық деректер көзін жасайды.
Практикалық қолдану
Бұл мүмкіндік келесі сценарийлер үшін маңызды:
- Өнім каталогының көмекшісі: клиенттерге ағымдағы өнім ассортименті, бағалары және қолжетімділігі туралы нақты уақыт режимінде кеңес беретін AI.
- Ақылды жарнама боты: кестеңізден алынған мүмкіндіктерді, сипаттамаларды немесе ұсыныстарды динамикалық түрде көрсету арқылы ұсыныстарыңызды жарнамалайтын бот.
Интеграцияға кестеңізді қалай дайындау керек
Бастау үшін кестелер бөліміне өтіңіз:
Содан кейін сіз "Кесте қосу" түймесін көресіз, ол модальды терезені ашады, онда кесте атауын енгізу қажет:
Кестеге атау енгізіп, "Дайын" түймесін басыңыз. Содан кейін жобада жаңа кесте жасалып, "Кестелер" бөлімінде пайда болады:
Кесте параметрлері
Кестені жасағаннан кейін жолдар мен бағандарды қосу керек. Ол үшін қажетті кесте картасындағы "Өту" түймесін тауып, оны басыңыз.
Сіз келесі параметрлерді көресіз:
Атауы бар бағанды қосу үшін "+" түймесін басыңыз:
Түймені басқан кезде модальды терезе ашылады, онда жаңа бағанның атауын енгізуге болады.
Баған атауын енгізгеннен кейін "Дайын" түймесін басыңыз, содан кейін кестеге жаңа баған қосылады. Қажетті бағандар мен жолдар санын қосыңыз.
Енді сіздің кестеңіз осылай көрінеді.
Кесте идентификаторын көшіріңіз (есте сақтаңыз): ол үшін мекенжай жолағын басыңыз:
Келесі қадам - құрастырушыдағы блоктарды конфигурациялауға көшейік.
Чат-бот құрастырушысында жұмыс
get_records_from_table() функциясы
get_info_from_table() функциясын пайдалану үшін чат-бот құрастырушысында бір блок қажет.
Mavibot-та тиісті қойындыға өтіп, триггері бар блокты (Бастау блогы немесе Триггер блогы) жасаңыз:
Айнымалыны анықтаңыз (ол AI көмекшісінің білімі үшін пайдаланылады): бұл мысалда айнымалы 'record'.
Калькулятордағы код үлгісі
project.****record``=``get_records_from_table(1)
project. - жоба конфигурациясында айнымалыны орнатуға арналған конструктор;record - айнымалы атауы;-
get_records_from_table(1) - функция, мұнда параметр кесте идентификаторы ретінде беріледі.
get_record_from_table() функциясы туралы толығырақ
get_records_from_table(table_id, start_row, count, start_col, end_col) – кестеден жазбаларды алу үшін
| Параметр | Сипаттамасы | Ескерту |
|---|---|---|
| ! table_id | кесте идентификаторы (міндетті параметр) | |
| start_row | қосымша параметр, бүтін сан. Ауқымның бастапқы жолын көрсетеді | кесте мәндерін оқуды бастау керек жол нөмірін қабылдайды, қоса алғанда. Тырнақшасыз көрсетілуі керек |
| count | қосымша параметр, бүтін сан. Алынатын жолдар санын көрсетеді | әдепкі мән: 1000. Максимум: 5000. Тырнақшасыз көрсетілуі керек |
| start_col | қосымша параметр, жол. Ауқымның бастапқы бағанын көрсетеді | кесте мәндерін оқуды бастау керек баған атауын қабылдайды, қоса алғанда. Тырнақшада көрсетілуі керек |
| end_col | қосымша параметр, жол. Ауқымның соңғы бағанын көрсетеді | кесте мәндерін оқу керек баған атауын қабылдайды, қоса алғанда. Тырнақшада көрсетілуі керек |
Белгілі бір нүктеден бастап барлық деректерді оқу үшін: Ауқымның басын ғана көрсетіңіз. Белгілі бір нүктеге дейін барлық деректерді оқу үшін: Ауқымның соңын ғана көрсетіңіз.
#{none} орнына, хабарламада #{} конструкциясын пайдаланып, жоба айнымалысына қандай деректер жазылғанын көру үшін айнымалымызды жазамыз.
Назар аударыңыз
Хабарламаға енгізілген айнымалы боттың функцияны дұрыс оқитынын тексеру үшін қажет. Блокты сынақ режимінде іске қосқанда, бот айнымалыға тағайындалатын мәндерді көрсетеді.
Ескерту
Блокты сынақ режимінде конфигурациялап, айнымалыны жоба параметрлерінде сақтағаннан кейін, бұл блокты жоймаңыз.
Ол сізге қажет болуы мүмкін: мысалы, кестеге қандай да бір мәндерді қосқан болсаңыз, блокты сынақ режимінде іске қосыңыз. Сонда жоба айнымалысындағы деректер жаңартылады.
Айнымалы атауы сізге ұнайтын кез келген атау болуы мүмкін.
Деректерді беру блогы
Келесі қадам - клиент картасына деректерді беру үшін "Чат" блогын жасаймыз.
"Бұл блок боттан жабу хабарламасын да жібере алады, мысалы: 'Мен ақпаратты менеджерге жіберемін! Менеджер 10 минут ішінде қосылады.'"
Содан кейін блок идентификаторын көшіріңіз. Ол сізге AI көмекшісін "start_block_from_ai 11956" пәрменінде және сынақ "Block call 11956" пәрменінде конфигурациялау үшін қажет болады, мұнда мысалдағы блок идентификаторының орнына өз блок идентификаторыңызды енгізу керек.
Ескерту
Сынақтан кейін "Block call 31241050" пәрменін "start_block_from_ai 31241050" пәрменіне ауыстырыңыз.
"Block call 31241050" пәрмені жөндеуге арналған және боттың қандай деректерді жазып жатқанын түсінуге көмектеседі ("Сынақ" бөлімін қараңыз).
Ботты клиенттер үшін іске қосу үшін "start_block_from_ai 31241050" пәрменін көрсетіңіз.
Кестені оқу
- Ботты сынау режиміне өтіңіз.
- Кесте деректерін оқуға арналған триггері бар блокты іске қосыңыз.
Блок дұрыс жұмыс істеді. Мұны жоба параметрлеріндегі сәйкес айнымалыда сақталған мәндер растайды.
Қолмен тексеру үшін:
- Жоба параметрлері бөліміне өтіңіз.
- Ағымдағы деректерін көру үшін айнымалыны табыңыз.
Жоба параметрлеріндегі "Айнымалылар" қойындысында сіз кестеден қосылған мәндері бар айнымалыңызды көресіз. Енді сіздің жобаңыздың ішінде тауарлар, құны және кестеде көрсеткен барлық нәрселері бар айнымалы бар.
AI көмекшісінде жұмыс
"AI көмекшісі" бөліміне өтіп, AI параметрлерімен чат-ботты іске қосыңыз.
"Сату көмекшісі" рөлін таңдау керек:
Сондай-ақ қосымша параметрлерді орнатамыз:
AI көмекшісінің параметрлері
Бот параметрлерінде келесі деректерді жазыңыз:
- Боттың позициясы мен нұсқаулары.
- Блокты шақыру және айнымалыларды жүйеге беру пәрмені келесідей жазылады:
"Егер бәрі дұрыс болса, "start_block_from_ai 11956" пәрменін орындаңыз", мұнда N орнына соңғы хабарламасы бар блок идентификаторы жазылады: Чат блогы деректерді клиент картасына жібереді:
Бот білімі
"Бот білімі" өрісінде триггері бар блок ретінде бұрын кэштелген айнымалыны беріңіз.
Бот білімі.
Осылайша, бот жоба параметрлеріндегі айнымалыдан ақпарат алып, клиенттеріңізге қолжетімді өнім ассортименті бойынша кеңес береді.
Деректер форматы
Берілетін деректер форматында сіз өзіңіз жинап жатқан деректерді (мысалы, өнімді) көрсетесіз, содан кейін "кілті" бар сөз тіркесін енгізіп, кілтке мән тағайындайсыз.
client_name кілтімен клиент аты, phone_number кілтімен клиент телефон нөмірі, city_address кілтімен қала мен мекенжай, product кілтімен таңдалған өнім, quantity кілтімен өнім саны, total_amount кілтімен жалпы тапсырыс сомасы.
Осылайша, блокты шақырған кезде айнымалылар клиент картасына беріледі: содан кейін айнымалылармен, мысалы, чат-бот құрастырушысында жұмыс істей аласыз:
Осы кезеңде AI көмекшісін орнату аяқталды.
Қалған параметрлерді өз қалауыңыз бойынша орнатуға болады:
Ботты сынау
"Егер сізде боттар жұмыс істеп тұрса, AI көмекшісінің іске қосу шартында тек сынақ терезесінде іске қосуды көрсетіңіз."
1-қадам. Триггер құрастырушысын басыңыз
2-қадам. Сынақ терезесі бар қойындыны таңдап, "Триггер қосу" түймесін басыңыз:
Енді триггер шартында келесі мәнді көресіз:
Осылайша, бот тек сынақ терезесінде және басқа еш жерде жұмыс істейді.
Ботты жөндегеннен кейін бұл шартты алып тастаңыз.
Бұл хабарлама "Block call 3124105" пәрменіне байланысты сынақ режимінде жіберілуде.
Ботты сынап, жөндегеннен кейін бот параметрлерінде "start_block_from_ai 31241050" пәрменін жазыңыз.
Бұл тәсіл сізге кез келген онлайн дүкен түрін құруға және кестеде сақталған кез келген деректер мәндерін пайдалануға мүмкіндік береді.
Жалғыз нақты шектеу - сіздің қиялыңыз.