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

内部授权

触发器的手动数据替换

响应的后处理