동일한 기능을 갖춘 PHP의 Yandex.Alisa 및 Telegram 봇

안녕하세요.

텔레그램 봇을 주제로 한 글은 많지만 앨리스의 스킬에 대해 글을 쓰는 사람은 거의 없고, 단일 봇을 만드는 방법에 대한 정보도 찾을 수 없어서 봇을 만드는 방법에 대한 경험을 공유하기로 했습니다. 동일한 기능을 가진 사이트에 대한 간단한 Telegram 봇과 Yandex.Alice 기술.

따라서 웹 서버를 구축하고 SSL 인증서를 얻는 방법에 대해서는 자세히 설명하지 않겠습니다.

텔레그램 봇 만들기

먼저 Telegram 봇을 만들어 보겠습니다. 이를 위해 Telegram으로 이동하여 거기에서 BotFather 봇을 찾습니다.

/newbot을 선택하세요

응답할 봇의 이름을 입력한 다음 봇의 이름을 입력하고 이에 대한 응답으로 봇을 제어할 토큰을 받고 이 키를 적어두면 나중에 유용할 것입니다.

다음 단계는 봇에서 데이터를 보낼 서버를 Telegram 서버에 알려주는 것입니다. 이를 위해 다음 형식의 링크를 만듭니다.

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의 스킬"을 선택하십시오.

스킬 설정 대화 상자가 열립니다.

스킬 설정에 들어가기 시작합니다.

스킬 이름을 입력하세요.

활성화 이름은 Alice가 뉘앙스로부터 올바르게 이해할 수 있도록 매우 신중하게 선택해야 합니다. Alice와 Yandex.Station 또는 Irbis A와 같은 열이 포함된 모바일 애플리케이션은 단어를 다르게 인식할 수 있습니다.

Telegram과 동일한 방식으로 서버에 스크립트 경로를 입력하지만 예를 들어 Alice를 위한 스크립트가 됩니다. www.my_server.ru/webhook_alice.php.

스킬이 말할 목소리를 선택하는데, 저는 앨리스의 목소리를 더 좋아합니다.

모바일 장치나 브라우저에서만 작업하려는 경우 "화면이 있는 장치가 필요합니다."를 선택하세요.

다음으로 Alice의 스킬 카탈로그 설정을 입력합니다. 활성화를 위해 "브랜드"라는 단어를 사용하려는 경우 webmaster.yandex.ru 서비스에서 브랜드 웹사이트를 확인해야 합니다.

설정이 모두 끝났습니다. 스크립트로 넘어 갑시다.

텔레그램 봇 스크립트

Telegram 스크립트부터 시작하겠습니다.

봇과 Alice의 메시지가 처리될 라이브러리를 연결합니다.

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의 기술 스크립트

이제 Alice의 스크립트로 넘어가겠습니다. Telegram의 스크립트와 거의 동일합니다.

또한 봇과 Alice의 메시지가 처리될 라이브러리와 Alice에 대한 클래스가 있는 라이브러리를 연결합니다.

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 봇을 사용할 수 있으며 Alice의 기술을 확인할 수 있습니다 Dialogs.yandex.ru/developer테스트 탭에서 새로운 기술로 이동하세요.

모든 것이 올바르게 작동하는 경우 "조정용" 버튼을 클릭하여 조정용 스킬을 보낼 수 있습니다.

이제 동일한 방식으로 작동하는 서로 다른 플랫폼에 대한 두 개의 봇이 동시에 있습니다.

Yandex.Dialogs 서비스에 대한 문서 여기에

github에 게시된 전체 스크립트 다운로드.

출처 : habr.com