alisa
1.0.2
Bot menggunakan konversi kata bentuk pertama agar lebih akurat mengenali kueri pengguna. Agar berfungsi dengan benar, Anda harus memiliki kamus kata-kata dalam bahasa yang diinginkan. Set ini cocok untuk bahasa Rusia. Wajib untuk menentukan jalur ke kamus.
$ bot = new alisa ( ' NAME ' );
//Такой используется по умолчанию
$ bot -> setDictionaryPath ( $ _SERVER [ ' DOCUMENT_ROOT ' ] . ' /dicts/ ' );Sesi – file *.json tempat semua informasi layanan disimpan dalam esensi satu dialog. Anda harus menentukan jalur ke direktori tempat data akan disimpan.
$ bot = new alisa ( ' NAME ' );
//Такой используется по умолчанию
$ bot -> setDictionaryPath ( $ _SERVER [ ' DOCUMENT_ROOT ' ] . ' /sessions/ ' ); //Создаем бота. Аргумент – название навыка
$ bot = new alisa ( ' myawesomebot ' );
//Создаем триггер, в качестве аргумента строка с уникальным именем
$ helloTrigger = new Trigger ( ' HELLO ' );
//Привязываем к триггеру токены – в данном случае в одну группу.
//Токены – ключевые слова, объединенные в группы
$ helloTrigger -> linkTokens ([ ' привет ' , ' здравствуйте ' , ' приветсвую ' ]);
$ bayTrigger = new Trigger ( ' bay ' );
$ bayTrigger -> linkTokens ([ ' пока ' , ' до свидания ' , ' прощай ' ]);
//Привязываем триггеры боту
$ bot -> addTrigger ( $ helloTrigger , $ bayTrigger );
//Отправляем ответ, если распознан $helloTrigger
$ bot ->sendResponse( $ helloTrigger , static function (){
//$answer - экземпляр отправляемого ответа
$ answer = new Response ();
$ answer -> addText ( ' Привет! ' );
$ answer -> addText ( ' Доброго времени суток! ' );
//обязательно возвращаем объект Response
return $ answer ;
);
//Отправляем ответ, если распознан $bayTrigger
$ bot ->sendResponse( $ bayTrigger , static function (){
$ answer = new Response ();
$ answer -> addText ( ' Прошай! ' );
$ answer -> addText ( ' Всего доброго ' );
//обязательно возвращаем объект Response
return $ answer ;
);Menurut protokol, bot setidaknya harus memiliki pemicu untuk salam dan penanganan kesalahan (panggilan bantuan).
//Будет вызван автоматически, при первом обращении пользователя к навыку
$ helloTrigger = new Trigger ( ' HELLO ' );
$ helloTrigger -> setAsInit ( true );
//Будет вызыван автоматически, если ну удалось распознать запрос
$ mistakeTrigger = new Trigger ( ' MISTAKE ' );
$ mistakeTrigger -> setAsMistake ( true );
//Отправляем ответ, если распознан $mistakeTrigger
$ bot -> sendResponse ( $ mistakeTrigger , static function (){
$ answer = new Answer ();
$ answer -> addText ( ' Не удалось понять вашу команду :( ' );
return $ answer ;
);Jika pemicu ini tidak ditentukan, bot akan mengirimkan respons default dengan link ke item ini. Dan jika ini alasan Anda membaca teks ini, lelucon itu berhasil.
Trigger adalah perintah yang harus ditanggapi oleh bot.
Token – kata kunci, atau opsi kueri (tergantung pada jenis pengenalan yang dipilih)
Mode ini menggunakan perbandingan berurutan dari kelompok token, hanya memilih opsi yang sesuai. Penguraian berlangsung dari kiri ke kanan - jika grup pertama tidak lolos pencarian, grup lainnya tidak akan diurutkan dan bot akan mulai melihat pemicu berikutnya. Ketika semua kelompok dimasukkan untuk pertama kalinya, pemicunya akan ditandai sebagai dikenali; jika tidak, mereka tidak akan berpartisipasi dalam analisis
$ greenTea -> linkTokens ([ ' дай ' , ' хочу ' , ' налей ' ],[ ' чай ' ],[ ' зеленый ' ]);
$ blackTea -> linkTokens ([ ' дай ' , ' хочу ' , ' налей ' ],[ ' чай ' ],[ ' черный ' , ' индийский ' ]);
$ coffeTrigger -> linkTokens ([ ' дай ' , ' хочу ' , ' налей ' ],[ ' кофе ' ]);Saat meminta "Tolong tuangkan teh hitam" $blackTea akan berfungsi; Saat bertanya “Saya tidak memiliki kekuatan untuk mendambakan kopi yang menyegarkan ini” – $coffeTrigger;
Kelebihan:
Kontra:
Berbeda dengan MORPHY_STRICT, kata kunci akan ditentukan secara otomatis, namun beberapa opsi kueri harus ditentukan. Semua pemicu disertakan dalam analisis; pemicu yang paling cocok dengan permintaan akan dipilih untuk pemicu yang dikenali.
$ greenTea -> linkTokens ([ ' Налей зеленого чая ' ],[ ' Хочу зеленого чая ' ],[ ' Дай зеленый чай ' ]);
$ blackTeas -> linkTokens ([ ' Налей чергого чая ' ],[ ' Хочу черного чая ' ],[ ' Дай черный чай ' ]);
$ coffeTrigger -> linkTokens ([ ' Налей кофе ' ],[ ' Хочу кофе ' ],[ ' Дай кофе ' ]);Kelebihan:
Kontra:
Jika bot digunakan untuk menjalankan perintah secara berurutan, Anda dapat mengikat pemicu berikutnya ke pemicu. Misalnya, jika Anda perlu mengumpulkan informasi apa pun dari pengguna, misalnya nama depan, nama belakang, dll.
// Декларируем триггеры
$ nameTrigger = new Trigger ( ' NAME ' );
$ sNameTrigger = new Trigger ( ' SECOND_NAME ' );
$ yoTrigger = new Trigger ( ' YEARS ' );
$ personTrigger = new Trigger ( ' PERSON ' );
// Назначаем токены для триггера
$ nameTrigger -> setTokens ([ ' давай ' , ' хочу ' , ' может ' ],[ ' знакомиться ' , ' познакомиться ' , ' представлюсь ' ]);
// Привязываем следующие триггеры
$ nameTrigger -> nextDelegate ( $ sNameTrigger );
$ sNameTrigger -> nextDelegate ( $ yoTrigger );
$ yoTrigger -> nextDelegate ( $ personTrigger );
// Обрабочтик запроса. Сработает если пользователь произнес "Давай познакомимся"
$ bot -> sendResponse ( $ nameTrigger , static function () use ( $ bot ){
$ answer = new Response ();
$ answer -> addText ( ' Какое твое имя? ' );
return $ answer ;
});
// После шага $nameTrigger сработает обработчик $sNameTrigger
$ bot -> sendResponse ( $ sNameTrigger , static function () use ( $ bot ){
$ answer = new Response ();
$ answer -> addText ( ' А фамилия? ' );
return $ answer ;
});
// После шага $sNameTrigger сработает обработчик $yoTrigger
$ bot -> sendResponse ( $ yoTrigger , static function () use ( $ bot ){
$ answer = new Response ();
$ answer -> addText ( ' Сколько тебе лет? ' );
return $ answer ;
});Untuk setiap pemicu, Anda perlu membuat penangan dengan pertanyaan. Saat pengguna meminta “Baiklah, mari berkenalan,” pemicu $nameTrigger akan diaktifkan. Untuk pemicu $sNameTrigger dan $yoTrigger, token tidak diperlukan (secara umum, dalam hal ini token tidak akan dapat berfungsi, karena pengguna akan mengirimkan informasi dan perintah tidak dapat dikenali di dalamnya), mereka akan dipanggil secara otomatis satu demi satu lain.
Pemicu dapat digunakan tidak hanya sebagai cara untuk menentukan perintah pengguna, tetapi juga untuk mengumpulkan informasi.
//$personTrigger – назначен как следующий триггер после $yoTrigger
$ bot -> sendResponse ( $ personTrigger , static function () use ( $ bot ){
//В качестве аргумента строка, уникальное название триггера
$ name = $ bot -> getTriggerData ( ' NAME ' );
$ sName = $ bot -> getTriggerData ( ' SECOND_NAME ' );
$ yo = $ bot -> getTriggerData ( ' YEARS ' );
$ answer = new Answer ();
$ answer -> addText ( " Хорошо { $ name } { $ sName } , я тебя запомнила, и что тебе { $ yo } лет – тоже " );
return $ answer ;
);Bot hanya menyimpan satu contoh data untuk pemicu, sehingga hanya data terakhir yang diterima yang dapat diambil
Respons adalah informasi yang dikirimkan bot kepada pengguna segera setelah pemicu dipicu.
//$personTrigger – назначен как следующий триггер после $yoTrigger
$ bot -> sendResponse ( $ personTrigger , static function () use ( $ bot ){
$ answer = new Answer ();
$ answer -> addText ( ' Один вариант ответа ' , ' Од!ин вари!ант отв!ета ' );
return $ answer ;
);Metode addText memiliki dua argumen string. Yang pertama digunakan untuk menampilkan teks yang akan ditampilkan kepada pengguna, yang kedua adalah teks yang sama dalam format TTS.
Untuk interaktivitas yang lebih besar, beberapa kemungkinan pilihan jawaban harus digunakan. Opsi pengiriman akan dipilih secara acak.
$ bot -> sendResponse ( $ bullshitTrigger , static function () {
$ answer = new Answer ();
$ answer -> addText ( ' Да не может быть! ' );
$ answer -> addText ( ' Чушь собачья! ' );
$ answer -> addText ( ' Не верю! ' );
return $ answer ;
);Anda dapat melampirkan tombol untuk merespons. Ini bisa berupa link ke halaman web atau tombol yang bila diklik akan memicu pemicu. Tombolnya bisa beberapa dan tipenya berbeda-beda.
$ bot -> sendResponse ( $ helloPerson , static function () {
$ answer = new Answer ();
$ answer -> addText ( ' Может познакомимся? ' );
$ buttonY = new Button ( ' Давай ' );
$ answer -> addButton ( $ button );
$ buttonN = new Button ();
$ buttonN -> setTitle ( ' Неа ' );
return $ answer ;
);Dalam contoh ini, ketika tombol diklik, $nameTrigger dari contoh di bagian “Delegasi” akan dipanggil. Jadi $nameTrigger dapat dipanggil dengan suara pengguna atau dengan menekan tombol jika pengguna tidak banyak bicara.
Bot Alice dapat menampilkan tombol kepada pengguna dalam dua bentuk berbeda - sebagai tombol yang ditempatkan di bawah dialog, dan sebagai tautan di dalam respons yang dikirim.
$ bButton = new Button ( ' Это кнопка ' );
//Будет отображена как кнопка, под диалогом. Со следующем ответом отображена не будет, если ее не привязатели к ответу Response
$ bButton -> setHide ( true );
$ bLink = new Button ( ' Это кнопка, но как ссылка ' )
//Будет отображена в ответе. Даже если пользователь выбирал что-то другие, эта ссылка так и останется в сообщении.
$ bButton-> setHide ( false ); $ bButton = new Button ( ' Это кнопка ' );
* * *
// Можно установить заголовок не в конструкторе, а в методе. Можно использовать как способ изменеия заголовка имеющейся кнопки, тем самым создавая вариативность
$ bButton -> setTitle ( ' Это все еще кнопка ' )
// К кнопке можно добавить ссылку. При клике на нее произойдет переход по адресу в браузере.
$ bButton -> addLink ( ' www.SITENAME.DOMAIN ' );
// Кнопке можно добавить обработчик какого-нибудь тригера. При клике на кнопку бот в первую очередь проверяет есть ли связанный Триггер для кнопки, и если есть – вызывает именно его.
$ bButton -> linkTrigger (Trigger $ trigger );
//Кнопке можно передать какие-нибудь данные, которые можно будет забрать и использовать, если пользователь нажимал на эту кнопку.
$ bButton -> addPayload ([ ' DATA ' => ' SOME_DATA ' ]);Selain data yang dikirim oleh pengguna, yang diikat dan disimpan oleh pemicu, Anda juga dapat menyimpan data Anda sendiri.
$ bot ->sendResponse( $ firstRequest , static function () use ( $ bot ) {
* * *
$ bot -> storeCommonData ( ' Черный чай ' , ' TEA ' );
$ bot -> getCommonData ( ' TEA ' ); // Вернет "Черный чай", в т.ч. если пользователь уже перешел к другому запросу
* * *
); $ bot ->sendResponse( $ secondRequest , static function () use ( $ bot ) {
* * *
$ bot -> getCommonData ( ' TEA ' ); // Вернет "Черный чай", в т.ч. если пользователь уже перешел к другому запросу
* * *
);Dalam kasus di mana pemicu tidak hanya melibatkan penerimaan data, tetapi juga validasi, perulangan harus digunakan
//Допустим что код триггера $chooseMeds – "MEDS"
$ bot -> sendResponse ( $ chooseMeds , static function () use ( $ bot ) {
$ answer = new Response ();
//Проверяем, это первичный запрос или цикл?
if ( ! $ bot -> isRepeatedRequest ()) {
//Нет, значит это первичный запрос со стороны пользователя, предлагаем выбор
$ answer -> addText ( ' Какую таблетку ты выберешь, Нео? ' );
//Задаем циклирование, результат будем проверять в этом же триггере
$ bot -> setRepeat ( true );
} else {
//Неправильный выбор?
if ( $ bot -> getTriggerData ( ' MEDS ' ) !== ' Синяя ' ) {
$ answer -> addText ( ' Неверный выбор, Нео ' );
//Задать цикл
$ bot -> setRepeat ( true );
} else {
//Все ок, выход из триггера
$ answer -> addText ( ' Ты сделал правильный выбор о-о ' );
}
}
return $ answer ;
});
