Yandex.Alisa და Telegram bot PHP-ში იგივე ფუნქციონირებით

მოგესალმებით.

არსებობს უამრავი სტატია ტელეგრამის ბოტების თემაზე, მაგრამ ცოტა ადამიანი წერს ალისის უნარებზე და მე ვერ ვიპოვე ინფორმაცია ერთი ბოტის შექმნის შესახებ, ამიტომ გადავწყვიტე გამეზიარებინა ჩემი გამოცდილება. მარტივი Telegram ბოტი და Yandex.Alice უნარ-ჩვევები საიტისთვის, რომელსაც აქვს იგივე ფუნქციონირება.

ასე რომ, მე არ გეტყვით, თუ როგორ უნდა აწიოთ ვებ სერვერი და მიიღოთ ssl სერთიფიკატი, ამის შესახებ საკმარისად დაიწერა.

Telegram ბოტის შექმნა

ჯერ შევქმნათ Telegram ბოტი, ამისთვის მივდივართ Telegram-ზე და იქ ვპოულობთ BotFather ბოტს.

აირჩიეთ /newbot

ვწერთ ბოტის სახელს, რომლითაც ის უპასუხებს, შემდეგ შევიყვანთ ბოტის სახელს, პასუხად ვიღებთ ბოტის მართვის ჟეტონს, ჩავწერთ ამ გასაღებს, ის გამოგვადგება მომავალში.

შემდეგი ნაბიჯი არის ტელეგრამის სერვერების მითითება, რომელ სერვერზე გაგზავნონ მონაცემები ბოტიდან. ამისათვის ჩვენ ვაკეთებთ ფორმის ბმულს:

https: //api.telegram.org/bot___ТОКЕН___/setWebhook?url=https://____ПУТЬ_ДО_СКРПИТА___

___TOKEN___ ჩვენ ვცვლით ჩვენს ჟეტონს ბოტიდან, ადრე მიღებული

____PATH_TO_SCRIPT____ ჩვენ ვცვლით სკრიპტის მისამართს ჩვენს სერვერზე, სადაც მოხდება მონაცემების დამუშავება (მაგალითად, www.my_server.ru/webhook_telegram.php).

აქ არის პრობლემა, api.telegram.org სერვერი დაბლოკილია, მაგრამ შეგიძლიათ ეს გააკეთოთ: იქირაოთ ყველაზე იაფი სერვერი, სადაც შეზღუდვები არ არის და მიეცით ბრძანება ამ სერვერის კონსოლიდან.

wget ___ПОЛУЧИВШИЙСЯ_АДРЕС___

ესე იგი, იქმნება Telegram ბოტი და უკავშირდება თქვენს სერვერს.

უნარების შექმნა Yandex.Alisa-სთვის

მოდით გადავიდეთ Yandex.Alice-ისთვის უნარების შექმნაზე.

უნარის შესაქმნელად, თქვენ უნდა გადახვიდეთ Yandex.Dialogues დეველოპერების გვერდზე Yandex.Dialogs დეველოპერის გვერდი, დააწკაპუნეთ იქ "დიალოგის შექმნა" და აირჩიეთ "უნარი ალისაში".

გაიხსნება უნარის პარამეტრების დიალოგი.

ჩვენ ვიწყებთ უნარების პარამეტრებში შესვლას.

შეიყვანეთ თქვენი უნარის სახელი.

აქტივაციის სახელი უნდა შეირჩეს ძალიან ფრთხილად, რათა ალისამ სწორად გაიგოს იგი, ნიუანსებიდან - მობილური აპლიკაცია Alice-ით და სვეტებით, როგორიცაა Yandex.Station ან Irbis A, შეუძლია სიტყვების განსხვავებულად აღქმა.

ჩვენ შევდივართ სკრიპტის გზას ჩვენს სერვერზე ისევე, როგორც Telegram-ისთვის, მაგრამ ეს იქნება სკრიპტი სპეციალურად ალისისთვის, მაგალითად. www.my_server.ru/webhook_alice.php.

ჩვენ ვირჩევთ ხმას, რომლითაც ეს უნარი ილაპარაკებს, მე უფრო მომწონს ალისის ხმა.

თუ გეგმავთ მუშაობას მხოლოდ მობილურ მოწყობილობებზე ან ბრაუზერში, აირჩიეთ „თქვენ გჭირდებათ მოწყობილობა ეკრანით“.

შემდეგი, შეიყვანეთ ალისის უნარების კატალოგის პარამეტრები. თუ თქვენ აპირებთ გამოიყენოთ სიტყვა "ბრენდი" გააქტიურებისთვის, თქვენ უნდა გადაამოწმოთ ბრენდის ვებგვერდი webmaster.yandex.ru სერვისში.

ეს ყველაფერი პარამეტრებზეა, მოდით გადავიდეთ სკრიპტებზე.

Telegram ბოტის სკრიპტი

დავიწყოთ Telegram-ის სკრიპტით.

ჩვენ ვუკავშირდებით ბიბლიოთეკას, სადაც დამუშავდება ბოტისა და ალისის შეტყობინებები:

include_once 'webhook_parse.php';

ჩვენ დავაყენეთ ჩვენი ბოტის ნიშანი:

$tg_bot_token = "_____YOUR_BOT_TOKEN_____";

ჩვენ ვიღებთ მონაცემებს:

$request = file_get_contents('php://input');
$request = json_decode($request, TRUE);

მონაცემების დაყოფა ცვლადებად:

if (!$request)
{
  die();
    // Some Error output (request is not valid JSON)
}
else if (!isset($request['update_id']) || !isset($request['message']))
{
  die();
    // Some Error output (request has not message)
}
else
{
  $user_id = $request['message']['from']['id'];
  $msg_user_name = $request['message']['from']['first_name'];
  $msg_user_last_name = $request['message']['from']['last_name'];
  $msg_user_nick_name = $request['message']['from']['username'];
  $msg_chat_id = $request['message']['chat']['id'];
  $msg_text = $request['message']['text'];


  $msg_text = mb_strtolower($msg_text, 'UTF-8');


  $tokens = explode(" ", $msg_text);
}

ახლა თქვენ შეგიძლიათ იმუშაოთ ცვლადებთან:

$tokens - აქ არის ყველა სიტყვა, რომელიც მომხმარებელმა შეიყვანა

$user_id - მომხმარებლის ID აქ

$msg_chat_id - ჩატი, რომელშიც ბოტმა მიიღო ბრძანება

$msg_user_name - მომხმარებლის სახელი

შემდეგი, ჩვენ ვუწოდებთ Parse_Tokens ფუნქციას დამუშავებისთვის:

$Out_Str = Parse_Tokens($tokens);

და გაგზავნეთ პასუხი:

Send_Out($user_id, $Out_Str);

Send_Out ფუნქცია მარტივია და ასე გამოიყურება:

function Send_Out($user_id, $text, $is_end = true)
{
  global $tg_bot_token;
  if (strlen($user_id) < 1 || strlen($text) < 1) {return;}
  $json = file_get_contents('https://api.telegram.org/bot' . $tg_bot_token . '/sendMessage?chat_id=' . $user_id . '&text=' . $text);
}

უნარების სკრიპტი Yandex.Alisa-სთვის

ახლა გადავიდეთ ალისის სკრიპტზე, ის თითქმის იგივეა, რაც Telegram-ისთვის.

ჩვენ ასევე ვუკავშირდებით ბიბლიოთეკას, სადაც დამუშავდება ბოტისა და ალისის შეტყობინებები, პლუს ბიბლიოთეკა ალისის კლასებით:

include_once 'classes_alice.php';
include_once 'webhook_parse.php';

ჩვენ ვიღებთ მონაცემებს:

$data = json_decode(trim(file_get_contents('php://input')), true);

მონაცემების დაყოფა ცვლადებად:

if (isset($data['request']))
{

//original_utterance


  if (isset($data['meta']))
  {
    $data_meta = $data['meta'];
    if (isset($data_meta['client_id'])) {$client_id = $data_meta['client_id'];}
  }

  if (isset($data['request']))
  {
    $data_req = $data['request'];

    if (isset($data_req['original_utterance']))
    {
      $original_utterance = $data_req['original_utterance'];
    }


    if (isset($data_req['command'])) {$data_msg = $data_req['command'];}
    if (isset($data_req['nlu']))
    {
      $data_nlu = $data_req['nlu'];
      if (isset($data_nlu['tokens'])) {$tokens = $data_nlu['tokens'];}
//      $data_token_count = count($data_tokens);
    }
  }
  if (isset($data['session']))
  {
    $data_session = $data['session'];
    if (isset($data_session['new'])) {$data_msg_new = $data_session['new'];}
    if (isset($data_session['message_id'])) {$data_msg_id = $data_session['message_id'];}
    if (isset($data_session['session_id'])) {$data_msg_sess_id = $data_session['session_id'];}
    if (isset($data_session['skill_id'])) {$skill_id = $data_session['skill_id'];}
    if (isset($data_session['user_id'])) {$user_id = $data_session['user_id'];}
  }
}

აქ არის რამდენიმე ნაკლები ცვლადი:

$tokens - აქ არის ყველა სიტყვა, რომელიც მომხმარებელმა შეიყვანა

$user_id - მომხმარებლის ID აქ

Yandex მუდმივად აწვდის გამოქვეყნებულ უნარებს და მე დავამატე ხაზი სკრიპტის დაუყოვნებლივ გასასვლელად, შეტყობინების სრული დამუშავების დაწყების გარეშე:

  if (strpos($tokens[0], "ping") > -1)     {Send_Out("pong", "", true);}

ჩვენ ვუწოდებთ Parse_Tokens ფუნქციას დამუშავებისთვის, ის იგივეა, რაც Telegram-ისთვის:

$Out_Str = Parse_Tokens($tokens);

და გაგზავნეთ პასუხი:

Send_Out($user_id, $Out_Str);

Send_Out ფუნქცია აქ უფრო რთულია:

function Send_Out($user_id, $out_text, $out_tts = "", $is_end = false)
{
  global $data_msg_sess_id, $user_id;

  ///// GENERATE BASE OF OUT //////
    $Data_Out = new Alice_Data_Out();
    $Data_Out->response = new Alice_Response();
    $Data_Out->session = new Alice_Session();
  ///// GENERATE BASE OF OUT End //////

  ///// OUT MSG GENERATE /////
  $Data_Out->session->session_id = $data_msg_sess_id;;
  $Data_Out->session->user_id = $user_id;

  $Data_Out->response->text = $out_text;
  $Data_Out->response->tts = $out_tts;

  if (strlen($out_tts) < 1) {$Data_Out->response->tts = $out_text;}

  $Data_Out->response->end_session = $is_end;

  header('Content-Type: application/json');
  print(json_encode($Data_Out, JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT));

  die();
}

დაასრულა ალისის სცენარი.

თავად Parse_Tokens დამუშავების სკრიპტი გაკეთდა მხოლოდ მაგალითისთვის, იქ შეგიძლიათ გააკეთოთ ნებისმიერი შემოწმება და დამუშავება.

function Parse_Tokens($tokens)
{
  $out = "";
  // do something with tokens //
  $out =  "Your eneter " . count($tokens) . " words: " . implode($tokens, " ");
  return $out;
}

თუ თქვენ გჭირდებათ უფრო რთული ფორმის მომხმარებელთან კომუნიკაცია, ვიდრე კითხვა-პასუხი, მაშინ თქვენ უნდა შეინახოთ მომხმარებლის $user_id და მომხმარებლისგან უკვე მიღებული მონაცემები მონაცემთა ბაზაში (მაგალითად, mysql) და გააანალიზოთ ისინი Parse_Tokens ფუნქცია.

სინამდვილეში, ეს თითქმის ყველაფერია, თუ ყველაფერი სწორად გაკეთდა, მაშინ Telegram ბოტი უკვე ხელმისაწვდომია, ალისის უნარი შეიძლება შემოწმდეს dialogs.yandex.ru/developerტესტირების ჩანართზე თქვენს ახალ უნარზე გადასვლით.

თუ ყველაფერი სწორად მუშაობს, შეგიძლიათ გაგზავნოთ უნარი მოდერაციისთვის ღილაკზე „მოდერაციისთვის“ დაწკაპუნებით.

ახლა თქვენ გაქვთ ორი ბოტი ერთდროულად სხვადასხვა პლატფორმისთვის, რომლებიც მუშაობენ ერთნაირად.

დოკუმენტაცია Yandex.Dialogues სერვისისთვის აქ

სრული სკრიპტები გამოქვეყნებულია github-ზე ჩამოტვირთვა.

წყარო: www.habr.com