alisa

Yandex.Alice 的機器人

預設

形態詞典

該機器人使用第一形式單字轉換來更準確地識別用戶的查詢。為了正確工作，您必須擁有所需語言的單字詞典。該套裝適用於俄語。必須指定字典的路徑。

alisa('NAME'); //Такой используется по умолчанию $bot->setDictionaryPath($_SERVER['DOCUMENT_ROOT'] . '/dicts/');">

 $ bot = new alisa ( ' NAME ' );                         
//Такой используется по умолчанию
$ bot -> setDictionaryPath ( $ _SERVER [ ' DOCUMENT_ROOT ' ] . ' /dicts/ ' );

會話儲存目錄

會話 – *.json 文件，其中所有服務資訊都儲存在一個對話的本質中。您必須指定儲存資料的目錄路徑。

alisa('NAME'); //Такой используется по умолчанию $bot->setDictionaryPath($_SERVER['DOCUMENT_ROOT'] . '/sessions/');">

 $ bot = new alisa ( ' NAME ' );                         
//Такой используется по умолчанию
$ bot -> setDictionaryPath ( $ _SERVER [ ' DOCUMENT_ROOT ' ] . ' /sessions/ ' );

工作協議

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; );">

 //Создаем бота. Аргумент – название навыка
$ 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 ;
);

標準觸發器

根據協議，機器人必須至少有一個用於問候和錯誤處理（呼叫幫助）的觸發器。

 //Будет вызван автоматически, при первом обращении пользователя к навыку
$ 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 ;
);

如果未定義這些觸發器，機器人將發送預設回應，其中包含指向此項目的連結。如果這就是您閱讀本文的原因，那麼這個惡作劇就成功了。

觸發器

扳機

觸發器是機器人必須回應的命令。

代幣

標記 – 關鍵字或查詢選項（取決於所選的識別類型）

MORPHY_STRICT

此模式使用標記組的順序比較，僅選擇適當的選項。解析從左到右進行 - 如果第一組未通過搜索，則剩餘組將不會被排序，機器人將開始查看下一個觸發器。當所有組別第一次進入時，觸發器將被標記為已識別，否則將不參與分析；

 $ greenTea -> linkTokens ([ ' дай ' , ' хочу ' , ' налей ' ],[ ' чай ' ],[ ' зеленый ' ]);
$ blackTea -> linkTokens ([ ' дай ' , ' хочу ' , ' налей ' ],[ ' чай ' ],[ ' черный ' , ' индийский ' ]);
$ coffeTrigger -> linkTokens ([ ' дай ' , ' хочу ' , ' налей ' ],[ ' кофе ' ]);

當請求“請倒一些紅茶”時，$blackTea 會起作用；當請求「我沒有力氣去喝這杯提神咖啡」 – $coffeTrigger；

優點：

• 很好地區分非常相似的查詢
• 當所有令牌組第一次匹配時，後續觸發器的處理停止
• 透過按順序新增觸發器，您可以確定將首先處理的觸發器。參見上面的觀點。
• 如果命令未被識別，可能會導致錯誤觸發。在這個例子中，當要求倒啤酒時，機器人會說它沒有這樣的權力。

缺點：

• 有必要嚴格確定特定關鍵字的重要性。對於 $greenTea 和 $blackTea 來說，前兩組類似，第三組代幣將起到決定性因素 - 紅茶或綠茶。
• 觸發器的數量和令牌組的數量都會影響工作速度。

達默勞-洛文斯坦

與 MORPHY_STRICT 不同，將自動決定關鍵字，但必須指定幾個查詢選項。所有觸發器都包含在分析中；將選擇與請求最匹配的觸發器作為已識別的觸發器。

 $ greenTea -> linkTokens ([ ' Налей зеленого чая ' ],[ ' Хочу зеленого чая ' ],[ ' Дай зеленый чай ' ]);
$ blackTeas -> linkTokens ([ ' Налей чергого чая ' ],[ ' Хочу черного чая ' ],[ ' Дай черный чай ' ]);
$ coffeTrigger -> linkTokens ([ ' Налей кофе ' ],[ ' Хочу кофе ' ],[ ' Дай кофе ' ]);

優點：

• 無需定義關鍵字組。僅指定使用者可能請求的幾個可能選項就足夠了
• 通常，請求的處理速度比 MORPHY_STRICT 的類似變體更快

缺點：

• 處理註冊令牌的所有觸發器。即使先選擇了正確的觸發器，其餘的觸發器仍然會通過測試。產生的觸發器是具有最高匹配度的觸發器。因此，觸發器越多，它的工作速度就越慢。
• 與 MORPHY_STRICT 不同，它不會導致識別錯誤訊息。這種模式總是會產生某種觸發。在此範例中，在要求倒啤酒後，由於某種原因，機器人倒了咖啡。

代表團

如果機器人用於順序執行命令，您可以將下一個觸發器綁定到觸發器。例如，如果您需要收集用戶的任何信息，例如名字、姓氏等。

 // Декларируем триггеры
$ 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 ;
});

對於每個觸發器，您需要建立一個帶有問題的處理程序。當使用者要求「好吧，讓我們熟悉一下」時，$nameTrigger 觸發器將觸發。對於觸發器 $sNameTrigger 和 $yoTrigger 來說，不需要令牌（一般情況下，在這種情況下它們將無法工作，因為用戶將傳輸資訊並且命令無法在其中被識別），它們將被自動調用又一個。

數據

觸發器不僅可以用作確定使用者命令的方式，還可以用來收集資訊。

 //$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 ;
);

機器人僅儲存觸發器的一個數據實例，因此只能檢索最後接收到的數據

答案

回應是觸發觸發器後機器人發送給使用者的信息。

文字和 TTS

 //$personTrigger – назначен как следующий триггер после $yoTrigger
$ bot -> sendResponse ( $ personTrigger , static function () use ( $ bot ){
    $ answer = new Answer ();
    $ answer -> addText ( ' Один вариант ответа ' , ' Од!ин вари!ант отв!ета ' );
    return $ answer ;
);

addText 方法有兩個字串參數。第一個用於輸出將顯示給使用者的文本，第二個是 TTS 格式的相同文字。

選項

為了獲得更好的互動性，應使用多種可能的答案選項。運輸選項將被隨機選擇。

 $ bot -> sendResponse ( $ bullshitTrigger , static function () {
    $ answer = new Answer ();
    $ answer -> addText ( ' Да не может быть! ' );
    $ answer -> addText ( ' Чушь собачья! ' );
    $ answer -> addText ( ' Не верю! ' );
    return $ answer ;
);

按鈕

您可以附加一個按鈕來回應。這可以是網頁連結或按鈕，點擊後將觸發觸發器。可以有多個按鈕和不同的類型。

 $ bot -> sendResponse ( $ helloPerson , static function () {
    $ answer = new Answer ();
    $ answer -> addText ( ' Может познакомимся? ' );
    $ buttonY = new Button ( ' Давай ' );
    $ answer -> addButton ( $ button );
    $ buttonN = new Button ();
    $ buttonN -> setTitle ( ' Неа ' );
    return $ answer ;
);

在此範例中，按一下按鈕時，將呼叫「Delegation」部分範例中的 $nameTrigger。因此，$nameTrigger 可以透過使用者的聲音來調用，也可以透過按下按鈕（如果使用者不愛說話）來調用。

按鈕

按鈕類型

Alice 機器人可以以兩種不同的形式向使用者顯示按鈕 - 作為放置在對話方塊下方的按鈕，以及作為發送回應內的連結。

 $ 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 ' ]);

儲存數據

除了用戶發送的由觸發器綁定並保存的資料外，您還可以保存自己的資料。

 $ bot ->sendResponse( $ firstRequest , static function () use ( $ bot ) {
    * * *
   $ bot -> storeCommonData ( ' Черный чай ' , ' TEA ' );
   $ bot -> getCommonData ( ' TEA ' ); // Вернет "Черный чай", в т.ч. если пользователь уже перешел к другому запросу
    * * *
);

 $ bot ->sendResponse( $ secondRequest , static function () use ( $ bot ) {
    * * *
   $ bot -> getCommonData ( ' TEA ' ); // Вернет "Черный чай", в т.ч. если пользователь уже перешел к другому запросу
    * * *
);

更多選擇

觸發重置

如果觸發器不僅涉及資料接受，還涉及驗證，則應使用循環

 //Допустим что код триггера $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 ;
});

內部授權

觸發器的手動資料替換

回應的後處理