{"id":5462,"date":"2018-08-14T15:20:07","date_gmt":"2018-08-14T13:20:07","guid":{"rendered":"https:\/\/sii.pl\/blog\/?p=5462"},"modified":"2023-01-27T12:02:25","modified_gmt":"2023-01-27T11:02:25","slug":"tworzenie-asystenta-do-telegram-z-logika-w-chmurze-azure","status":"publish","type":"post","link":"https:\/\/sii.pl\/blog\/tworzenie-asystenta-do-telegram-z-logika-w-chmurze-azure\/","title":{"rendered":"Tworzenie asystenta do Telegram z logik\u0105 w chmurze Azure"},"content":{"rendered":"\n

Chcia\u0142bym opowiedzie\u0107 par\u0119 s\u0142\u00f3w o tym jak my, programi\u015bci, mo\u017cemy wykorzystywa\u0107 nowoczesne technologie dla naszych prostych potrzeb. Przedstawi\u0119 proces tworzenia bota, kt\u00f3ry b\u0119dzie pobiera\u0107 od u\u017cytkownika link do filmiku na serwisie YouTube i zwraca\u0107 plik audio jako odpowied\u017a. Wszystko b\u0119dziemy robi\u0107 za pomoc\u0105 komunikatora Telegram.<\/p>\n\n\n\n

Telegram jest to popularne w ostatnim czasie narz\u0119dzie do komunikacji, kt\u00f3re wype\u0142nia przestrze\u0144 informacyjn\u0105. Dzi\u0119ki prostocie i jako\u015bci \u2013 coraz mocniej i mocniej zast\u0119puje konkurencyjne rozwi\u0105zania. Jednym z trend\u00f3w minionego roku by\u0142o wprowadzenie wszelkiego rodzaju wirtualnych asystent\u00f3w czy te\u017c pomocnik\u00f3w i o tym w\u0142a\u015bnie chcia\u0142bym dzisiaj opowiedzie\u0107. Tre\u015bci\u0105 tego artyku\u0142u b\u0119dzie prosta prezentacja, jak zacz\u0105\u0107 korzysta\u0107 z us\u0142ug w chmurze ju\u017c teraz. Niniejszy wpis skierowany jest do programist\u00f3w, kt\u00f3rzy chc\u0105 by\u0107 w trendzie nowoczesnego programowania oraz s\u0105 zainteresowani us\u0142ugami w chmurze Microsoft.<\/p>\n\n\n\n

Konfiguracja Telegram<\/strong><\/h2>\n\n\n\n

Telegram to komunikator, kt\u00f3ry zapewnia wygodny interfejs oraz dokumentacj\u0119 do tworzenia bot\u00f3w (https:\/\/core.telegram.org\/<\/a>). W celu dodania swojego w\u0142asnego bota do systemu Telegram, programista powinien wyszuka\u0107 w\u015br\u00f3d wszystkich u\u017cytkownik\u00f3w asystenta, kt\u00f3rego imi\u0119 jest\u00a0BotFather (stworzonego przez tw\u00f3rc\u00f3w Telegram)<\/em>.\u00a0 Asystent pomaga tworzy\u0107 nowe boty oraz zmienia\u0107 ustawienia istniej\u0105cych. Aby utworzy\u0107 \u00a0nowego bota nale\u017cy napisa\u0107 do niego, wykorzystuj\u0105c polecenie\u00a0\/newbot<\/strong>\u00a0.\u00a0BotFather<\/em>\u00a0poprosi o imi\u0119 oraz nazw\u0119 u\u017cytkownika. Nast\u0119pnie zostanie wygenerowany token autoryzacyjny dla nowego bota, kt\u00f3ry jest niezb\u0119dny do autoryzacji wysy\u0142ania zapyta\u0144 do API.<\/p>\n\n\n\n

\"Tworzenie<\/a>
Tworzenie asystenta(bota) o nazwie \u00abAudioLoaderBot\u00bb<\/figcaption><\/figure><\/div>\n\n\n\n

Konfiguracja us\u0142ugi w chmurze Azure<\/strong><\/h2>\n\n\n\n

Wykonywanie zapyta\u0144 oraz logika b\u0119d\u0105 uruchamiane w chmurze Microsoft Azure<\/em> za pomoc\u0105 mechanizmu Azure Functions<\/em>, w kt\u00f3rej umie\u015bcimy w\u0142a\u015bciwy kod do obs\u0142ugi naszego bota.<\/p>\n\n\n\n

Troch\u0119 o kosztach<\/strong><\/p>\n\n\n\n

Istniej\u0105 dwa podej\u015bcia do wyliczania koszt\u00f3w za korzystanie z us\u0142ug w chmurze Azure<\/em>. Pierwszy spos\u00f3b polega na tym, \u017ce us\u0142uga Functions<\/em> jest rozliczana na podstawie zaobserwowanego u\u017cycia zasob\u00f3w mierzonego w sekundach i gigabajtach pami\u0119ci (GB-s). Zaobserwowane u\u017cycie zasob\u00f3w jest obliczane przez pomno\u017cenie \u015bredniego rozmiaru pami\u0119ci w gigabajtach przez czas w milisekundach potrzebny na wykonanie funkcji. Pami\u0119\u0107 u\u017cyta przez funkcj\u0119 jest zaokr\u0105glana w g\u00f3r\u0119 do najbli\u017cszych 128 MB przy maksymalnym rozmiarze pami\u0119ci 1 536 MB. Czas wykonywania jest obliczany przez zaokr\u0105glenie w g\u00f3r\u0119 do najbli\u017cszej 1 ms. Minimalny czas wykonywania i pami\u0119\u0107 dla pojedynczego wykonania funkcji to odpowiednio 100 ms i 128 MB. Ceny us\u0142ugi typu Functions<\/em> uwzgl\u0119dniaj\u0105 miesi\u0119czny bezp\u0142atny przydzia\u0142 400 000 GB-s. Drugie podej\u015bcie opiera si\u0119 na liczbie wywo\u0142a\u0144 funkcji, przy czym 1 mln po\u0142\u0105cze\u0144 funkcji jest darmowych. Deweloper sam mo\u017ce zdecydowa\u0107, co najlepiej pasuje dla jego potrzeb.<\/p>\n\n\n\n

Na pocz\u0105tek utworzymy now\u0105 instancj\u0119 funkcji. W tym celu na portalu Azure (https:\/\/portal.azure.com\/<\/a>) trzeba klikn\u0105\u0107 w pole wyszukiwarki i wpisa\u0107 s\u0142owo kluczowe \u00abFunctions\u00bb<\/em>\u00a0albo znale\u017a\u0107 t\u0105 us\u0142ug\u0119 w li\u015bcie po lewej stronie w\u00a0\u00bb<\/em>.\u00a0 Pojawi si\u0119 dodatkowe okno, w kt\u00f3rym\u00a0 wybieramy sekcj\u0119 \u00abCompute\u00bb<\/em>. Nast\u0119pnie\u00a0 nale\u017cy wybra\u0107 \u00abFunction App\u00bb<\/em>. Zostanie otwarty formularz do wst\u0119pnej konfiguracji us\u0142ugi, kt\u00f3ry w miar\u0119 jego nape\u0142niania intuicyjnie podpowiada u\u017cytkownikowi mo\u017cliwe warto\u015bci. Po utworzeniu instancji aplikacji typu \u00abFunctions App\u00bb<\/em>, u\u017cytkownik b\u0119dzie mia\u0142 dost\u0119p do panelu sterowania funkcj\u0105, gdzie mo\u017cna zobaczy\u0107 list\u0119 swoich funkcji, zmienia\u0107 ustawienia sieci, dodawa\u0107 proxy, etc.<\/p>\n\n\n\n

\"Panel<\/a>
Panel sterowania funkcj\u0105<\/figcaption><\/figure><\/div>\n\n\n\n

Dalej stworzymy nasz\u0105 funkcj\u0119 za pomoc\u0105 przycisku \u00abNew function\u00bb<\/em>. U\u017cytkownik b\u0119dzie mia\u0142 mo\u017cliwo\u015b\u0107 wybra\u0107 jeden z kilku szablon\u00f3w funkcji, wykorzystuj\u0105c przy tym r\u00f3\u017cne j\u0119zyki programowania takie jak C#, F# oraz JavaScript.<\/p>\n\n\n\n

W naszym przypadku wybieramy szablon funkcji nazywaj\u0105cy si\u0119 \u00abHTTP Trigger<\/em>\u00bb, kt\u00f3ry przyjmuje i wysy\u0142a \u017c\u0105dania typu\u00a0HTTP<\/em>. Wprowadzamy nazw\u0119 dla funkcji, wybieramy poziom autoryzacji i nast\u0119pnie j\u0105 zatwierdzamy.<\/p>\n\n\n\n

\"Dodawanie<\/a>
Dodawanie nowej funkcji<\/figcaption><\/figure><\/div>\n\n\n\n

Funkcja zosta\u0142a stworzona. U\u017cytkownik mo\u017ce wykorzysta\u0107 minimalistyczne \u015brodowisko deweloperskie dla rozwoju i testowania funkcji bezpo\u015brednio w przegl\u0105darce. W \u015brodkowej cz\u0119\u015bci ekranu umieszczony jest edytor kodu, natomiast z prawej strony umieszczony jest ma\u0142y modu\u0142 do testowania, w kt\u00f3rym mo\u017cna tworzy\u0107 zapytania, oraz \u015bledzi\u0107 ich wykonanie.<\/p>\n\n\n\n

\"Obszar<\/a>
Obszar roboczy – g\u0142\u00f3wny widok<\/figcaption><\/figure><\/div>\n\n\n\n

Zak\u0142adka \u00abView files<\/em>\u00bb pozwala wy\u015bwietli\u0107 katalog\u00a0 funkcji, dodawa\u0107\/edytowa\u0107\/usuwa\u0107 pliki. Dodatkowo mo\u017cna edytowa\u0107 plik\u00a0project.json<\/em>, gdy jest potrzeba zarz\u0105dza\u0107 pakietami\u00a0NuGet<\/em>\u00a0albo skonfigurowa\u0107 wykorzystywane modu\u0142y.<\/p>\n\n\n\n

\"Struktura<\/a>
Struktura plik\u00f3w zwyk\u0142ej funkcji<\/figcaption><\/figure><\/div>\n\n\n\n

Plik\u00a0run.csx<\/em>\u00a0umo\u017cliwia wykonywanie g\u0142\u00f3wnej funkcji\u00a0Run<\/em>\u00a0(funkcja zosta\u0142a pokazana na powy\u017cszym zrzucie ekranu w okienku dla edytowania kodu). Pliki\u00a0AudioSender.csx<\/em>\u00a0oraz\u00a0TelegramAudioFile.csx<\/em>\u00a0zosta\u0142y utworzone przeze mnie. Zmodyfikujmy tre\u015b\u0107 funkcji Run:<\/p>\n\n\n\n

\"Modyfikacja<\/a>
Pe\u0142n\u0105 i aktualn\u0105 wersj\u0119 kodu mo\u017cna zobaczy\u0107 pod linkiem:\u00a0https:\/\/github.com\/ihorbodia\/AudioLoaderBot<\/a><\/figcaption><\/figure><\/div>\n\n\n\n

Plik\u00a0project.json<\/em>\u00a0jest plikiem konfiguracyjnym, kt\u00f3ry pomo\u017ce okre\u015bli\u0107 pakiety\u00a0NuGet,<\/em>\u00a0kt\u00f3re nale\u017cy u\u017cy\u0107. W naszym przypadku wygl\u0105da on nast\u0119puj\u0105co:<\/p>\n\n\n\n

\"Struktura<\/a>
Struktura pliku project.json<\/figcaption><\/figure><\/div>\n\n\n\n

Uwaga! Je\u015bli biblioteki, kt\u00f3re chcesz u\u017cy\u0107 w swojej funkcji nie s\u0105 dystrybuowane  jako pakiety NuGet<\/em>, trzeba u\u017cy\u0107 mechanizm KUDU<\/em>. Jest to zestaw narz\u0119dzi, kt\u00f3ry pozwala przeprowadzi\u0107 bardziej szczeg\u00f3\u0142ow\u0105 diagnostyk\u0119 i ustawienia us\u0142ugi. Wi\u0119cej szczeg\u00f3\u0142\u00f3w: https:\/\/blogs.msdn.microsoft.com\/benjaminperkins\/2017\/04\/13\/how-to-add-assembly-references-to-an-azure-function-app\/<\/a><\/p>\n\n\n\n

Ko\u0144cowym krokiem w dostosowywaniu us\u0142ug w chmurze b\u0119dzie otrzymanie linka \u2013 webhooka, pod kt\u00f3rym b\u0119dzie dost\u0119pna us\u0142uga. Aby to zrobi\u0107 nale\u017cy nacisn\u0105\u0107 na przycisk \u00abGet Function URL<\/em>\u00bb , kt\u00f3ry znajduje si\u0119 nad edytorem kodu. Ten link jest potrzebny do tego, aby stworzony wcze\u015bniej asystent w aplikacji\u00a0Telegram<\/em>\u00a0wiedzia\u0142 gdzie ma wys\u0142a\u0107 zapytanie\u00a0HTTP<\/em>. W danym przypadku to wygl\u0105da nast\u0119puj\u0105co:<\/p>\n\n\n\n

\"8<\/a><\/figure><\/div>\n\n\n\n

Aby powi\u0105za\u0107 bota z funkcj\u0105 w Azure<\/em> nale\u017cy otworzy\u0107 odno\u015bnik:<\/p>\n\n\n\n

https:\/\/api.telegram.org\/bot<YOUR_API_TOKEN><\/strong>\/setwebhook?url=<HTTPS_url_to_send_updates_to><\/strong><\/em><\/p>\n\n\n\n

W kt\u00f3rym:<\/p>\n\n\n\n

<YOUR_API_TOKEN><\/em><\/strong> \u2013 <\/strong>token \/ klucz, kt\u00f3ry zosta\u0142 uzyskany przy tworzeniu naszego bota w Telegram<\/em> (za pomoc\u0105 BotFather<\/em>) i jest potrzebny do autoryzacji asystenta<\/p>\n\n\n\n

<HTTPS_url_to_send_updates_to><\/em><\/strong> \u2013 <\/strong>link \/webhook do obs\u0142ugi \u017c\u0105da\u0144, znajduj\u0105cy si\u0119 pod adresem us\u0142ugi<\/p>\n\n\n\n

\u00a0Je\u015bli uruchomimy odno\u015bnik w przegl\u0105darce, powinna pojawi\u0107 si\u0119 prosta odpowied\u017a w postaci JSON:<\/p>\n\n\n\n

\"8.1<\/a>
Odpowied\u017a serwera Telegram o pomy\u015blnym ustawieniu webhooka<\/figcaption><\/figure><\/div>\n\n\n\n

Po tej akcji, us\u0142uga w\u00a0Azure<\/em>\u00a0b\u0119dzie otrzymywa\u0107 wiadomo\u015bci z chatu i odpowiada\u0107 na nie:<\/p>\n\n\n\n

\"Wizualizacja<\/a><\/figure><\/div>\n\n\n\n

Jak wida\u0107, efektem naszej pracy jest uzyskanie prostego bota umo\u017cliwiaj\u0105cego przetwarzanie plik\u00f3w wideo na audio i odpornego na b\u0142\u0119dne wiadomo\u015bci. Bot mo\u017ce by\u0107 przydatny dla ludzi, kt\u00f3rzy lubi\u0105 s\u0142ucha\u0107 podcast\u00f3w i jednocze\u015bnie wykonuj\u0105 inne zadania. Us\u0142uga w Azure jest niezale\u017cna od Telegramu i jest og\u00f3lnodost\u0119pna jako publiczne API. Ma zdefiniowan\u0105 sygnatur\u0119 przyjmowanych \u017c\u0105da\u0144 oraz mo\u017ce pracowa\u0107 nie tylko z messengerem Telegram<\/em>.<\/p>\n\n\n\n

Rozbudowuj\u0105c naszego bota, mo\u017cna dodawa\u0107 r\u00f3\u017cne funkcjonalno\u015bci, na przyk\u0142ad mo\u017cliwo\u015b\u0107 ustawienia przep\u0142ywno\u015bci (bit rate<\/em>), co zmniejszy rozmiar pliku wynikowego czy formatu (MP3<\/em>\/WMA<\/em>\/OGG<\/em>).<\/p>\n\n\n

\n \n
\n \n
\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n <\/div>\n \n
\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n <\/div>\n<\/div>\n \n\n
\n 3.7\/5 ( votes: 3) <\/div>\n <\/div>\n","protected":false},"excerpt":{"rendered":"

Chcia\u0142bym opowiedzie\u0107 par\u0119 s\u0142\u00f3w o tym jak my, programi\u015bci, mo\u017cemy wykorzystywa\u0107 nowoczesne technologie dla naszych prostych potrzeb. Przedstawi\u0119 proces tworzenia … Continued<\/a><\/p>\n","protected":false},"author":163,"featured_media":5477,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_editorskit_title_hidden":false,"_editorskit_reading_time":0,"_editorskit_is_block_options_detached":false,"_editorskit_block_options_position":"{}","inline_featured_image":false,"footnotes":""},"categories":[1314],"tags":[129,111],"class_list":["post-5462","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-development-na-twardo","tag-c","tag-web-development"],"acf":[],"aioseo_notices":[],"republish_history":[],"featured_media_url":"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2018\/06\/action-blur-electronics-247932.jpg","category_names":["Development na twardo"],"_links":{"self":[{"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/posts\/5462"}],"collection":[{"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/users\/163"}],"replies":[{"embeddable":true,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/comments?post=5462"}],"version-history":[{"count":2,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/posts\/5462\/revisions"}],"predecessor-version":[{"id":19017,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/posts\/5462\/revisions\/19017"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/media\/5477"}],"wp:attachment":[{"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/media?parent=5462"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/categories?post=5462"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/tags?post=5462"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}