Yandex.Alice i Telegram bot na PHP sa jedinstvenom funkcionalnošću

Dobar dan.

Postoji mnogo članaka o Telegram botovima, ali malo ko piše o veštinama za Alisu, a informacija o tome kako napraviti jedinstvenog bota nisam mogao da pronađem, pa sam odlučio da podelim svoje iskustvo o tome kako napraviti jednostavnog Telegram bota i veštinu Yandex.Alice za sajt koji ima jedinstvenu funkcionalnost.

Dakle, kako podići veb-server i dobiti ssl sertifikat neću pričati, o tome je dovoljno napisano.

Kreiranje Telegram bota

Prvo ćemo napraviti Telegram bota, za to idemo u Telegram i tražimo bota BotFather.

Yandex.Alice i Telegram bot na PHP sa jedinstvenom funkcionalnošću

Yandex.Alice i Telegram bot na PHP sa jedinstvenom funkcionalnošću

Biramo /newbot

Yandex.Alice i Telegram bot na PHP sa jedinstvenom funkcionalnošću

Unosimo naziv bota po kojem će se javljati, zatim unosimo ime bota, u odgovoru dobijamo token za upravljanje botom, beležimo ovu šifru, biće nam potrebna kasnije.

Yandex.Alice i Telegram bot na PHP sa jedinstvenom funkcionalnošću

Sledeći korak je obavestiti Telegram servere na koji server slati podatke od bota. Za to pravimo link u obliku:

https://api.telegram.org/bot___TOKEN___/setWebhook?url=https://____PUT_DO_SCRIPT-a___

___TOKEN___ zamenjujemo našim tokenom od bota, dobijenim ranije

____PUT_DO_SCRIPT-a___ zamenjujemo adresom skripte na našem serveru, gde će se vršiti obrada podataka (na primer, www.moj_server.ru/webhook_telegram.php).

Tu je problem, server api.telegram.org je pod blokadom, ali može se učiniti ovako: iznajmiti najjeftiniji server server gde nema ograničenja i dati iz konzole tog servera komandu

wget ___DOBIJENA_ADRESA___

Sve, Telegram bot je napravljen i povezan sa vašim serveru.

Kreiranje veštine za Yandex.Alicu

Prelazimo na kreiranje veštine za Yandex.Alicu.

Za izradu veštine potrebno je otići na stranicu za programere Yandex.Dijalozi stranicu za programere Yandex.Dijalozi, kliknuti na "Kreirati dijalog" i odabrati "Veština u Alisi".

Yandex.Alice i Telegram bot na PHP sa jedinstvenom funkcionalnošću

Otvorit će se dijalog za podešavanje veštine.

Yandex.Alice i Telegram bot na PHP sa jedinstvenom funkcionalnošću

Počinjemo unositi podešavanja veštine.

Unosimo ime vaše veštine.

Yandex.Alice i Telegram bot na PHP sa jedinstvenom funkcionalnošću

Aktivacijsko ime treba pažljivo birati kako bi Alisa pravilno razumela, od sitnica – mobilna aplikacija sa Alisom i uređaji poput Yandex.Stanice ili Irbis A mogu različito razumeti reči.

Unosimo put do skripte na našem serveru na sličan način kao za Telegram, ali to će biti skripta isključivo za Alisu, na primer www.moj_server.ru/webhook_alice.php.

Yandex.Alice i Telegram bot na PHP sa jedinstvenom funkcionalnošću

Biramo glas kojim će veština govoriti, meni se više dopada glas Alise.

Yandex.Alice i Telegram bot na PHP sa jedinstvenom funkcionalnošću

Ako se planira rad samo na mobilnim uređajima ili u pretraživaču, biramo „Potrebno je uređaj sa ekranom“.

Zatim unosimo podešavanja za katalog veština Alise. Ako planirate da koristite reč za aktivaciju — brend, potrebno je da verifikujete vebsajt brenda na servisu webmaster.yandex.ru.

Yandex.Alice i Telegram bot na PHP sa jedinstvenom funkcionalnošću

Sa podešavanjima smo završili, prelazimo na skripte.

Skripta Telegram-bota

Počnimo sa skriptom za Telegram.

Povezujemo biblioteku koja će obrađivati poruke od bota i Alise:

include_once 'webhook_parse.php';

Postavljamo token našeg bota:

$tg_bot_token = "_____YOUR_BOT_TOKEN_____";

Dobijamo podatke:

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

Razlažemo podatke na promenljive:

if (!$request)
{
  die();
    // Neka greška (zahtev nije validan JSON)
}
else if (!isset($request['update_id']) || !isset($request['message']))
{
  die();
    // Neka greška (zahtev nema poruku)
}
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);
}

Sada možemo raditi sa promenljivama:

$tokens — ovde su sve reči koje je korisnik unio

$user_id — ovde je id korisnika

$msg_chat_id — chat u kojem je bot primio komandu

$msg_user_name — ime korisnika

Zatim, pozivamo funkciju Parse_Tokens za obradu:

$Out_Str = Parse_Tokens($tokens);

I šaljemo odgovor:

Send_Out($user_id, $Out_Str);

Funkcija Send_Out je jednostavna i izgleda ovako:

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

 

Skripta veštine za Yandex.Alice

Sada prelazimo na skriptu za Alisu, ona je gotovo identična onoj za Telegram.

Takođe povezujemo biblioteku koja će obrađivati poruke od bota i Alise, plus biblioteku sa klasama za Alisu:

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

Dobijamo podatke:

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

Razlažemo podatke na promenljive:

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

//original_utterance


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

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

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


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

Ovdje je manje potrebnih varijabli:

$tokens — ovde su sve reči koje je korisnik unio

$user_id — ovde je id korisnika

Yandex konstantno pinguje objavljene vještine, pa sam dodao liniju da odmah izađem iz skripte, ne pokrećući punu obradu poruke:

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

Pozivamo funkciju Parse_Tokens za obradu, ona je ista kao za Telegram:

$Out_Str = Parse_Tokens($tokens);

I šaljemo odgovor:

Send_Out($user_id, $Out_Str);

Funkcija Send_Out ovdje je malo složenija:

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;

  ako (strlen($out_tts) 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();
}

Završili smo skriptu za Alisu.

Samu skriptu za obradu Parse_Tokens sam napravio isključivo za primjer, vi možete raditi bilo kakve provjere i obrade u njoj.

function Parse_Tokens($tokens)
{
  $out = "";
  // uradi nešto s tokenima //
  $out =  "Vaš unos " . count($tokens) . " riječi: " . implode($tokens, " ");
  return $out;
}

Ako vam je potrebna komunikacija s korisnikom složenijeg tipa od pitanja i odgovora, potrebno je sačuvati u bazi (npr. mysql) $user_id korisnika i već primljene podatke od korisnika i analizirati ih u funkciji Parse_Tokens.

To je zapravo gotovo sve, ako je sve urađeno ispravno, Telegram bot je već dostupan, Alisovu vještinu možete provjeriti dialogs.yandex.ru/developer, prelazeći u svoju novu vještinu na karticu testiranje.

Yandex.Alice i Telegram bot na PHP sa jedinstvenom funkcionalnošću

Ako sve ispravno radi, možete poslati vještinu na moderaciju, klikajući na dugme "Na moderaciju".

Sada imate dva bota za različite platforme koja rade na isti način.

Dokumentacija za uslugu Yandex.Dialogs ovde

Potpuni skripti su objavljeni na github-u preuzeti.

Izvor: habr.com

Kupite pouzdan hosting za sajtove uz zaštitu od DDoS, VPS VDS servere 🔥 Kupite pouzdan hosting za sajtove uz zaštitu od DDoS, VPS VDS servere | ProHoster