https://github.com/clusterm/alicenet

.NET библиотека для лёгкого и быстрого создания навыков для Алисы от Яндекса.
https://github.com/clusterm/alicenet

yandex yandex-alice yandex-alisa

Last synced: about 1 month ago
JSON representation

.NET библиотека для лёгкого и быстрого создания навыков для Алисы от Яндекса.

• Host: GitHub
• URL: https://github.com/clusterm/alicenet
• Owner: ClusterM
• License: gpl-3.0
• Created: 2024-02-18T21:11:48.000Z (11 months ago)
• Default Branch: master
• Last Pushed: 2024-02-25T21:58:12.000Z (11 months ago)
• Last Synced: 2024-11-24T19:48:11.288Z (about 2 months ago)
• Topics: yandex, yandex-alice, yandex-alisa
• Language: C#
• Homepage:
• Size: 135 KB
• Stars: 5
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# Alice.NET

.NET библиотека для лёгкого и быстрого создания навыков для Алисы от Яндекса. Она уже содержит простенький веб-сервер.

## Скачать из NuGet

`dotnet add package AliceNet`

## Документация

Автоматически собранная документация тут: https://clusterm.github.io/AliceNet/

Подробнее про настройку навыков и значения переменных смотрите в документации Яндекса: https://yandex.ru/dev/dialogs/alice/doc/

Библотека явно ориентирована на русскоязычых разработчиков, поэтому все комментарии и документация на русском языке.

## Как использовать

Нужно создать класс, который наследуется от класса `AliceServerBase` и переопределить метод `HandleRequest`. 

В этом методе нужно обработать запрос и вернуть ответ. Теперь нужно создать экземпляр класса, указав конструкторы

на локальный endpoint и вызвать метод `Start()`.

```C#

using wtf.cluster.AliceNet;

using wtf.cluster.AliceNet.Types;

using wtf.cluster.AliceNet.Types.Request.Entities;

using wtf.cluster.AliceNet.Types.Request.RequestBody;

using wtf.cluster.AliceNet.Types.Response;

namespace AliceExample

{

    internal class Program

    {

        static async Task Main(string[] args)

        {

            var server = new AliceServer("http://localhost:8080/alice/");

            server.Start();

            await Task.Delay(Timeout.InfiniteTimeSpan);

        }

    }

    internal class AliceServer(string localEndpoint) : AliceServerBase(localEndpoint, logger: null)

    {

        protected override async Task HandleRequest(AliceReqest request, CancellationToken cancellationToken = default)

        {

            if (request.Session.New)

            {

                return new AliceResponse

                {

                    Response = new ResponseBody

                    {

                        Text = "Привет, это Алиса! Скажи триста!",

                        Buttons = [

                                new Button

                                {

                                    Title = "Открыть репозиторий",

                                    Url = "https://github.com/ClusterM/AliceNet"

                                }

                            ]

                    }

                };

            }

            else if (request.RequestBody is SimpleUtterance su && su.Nlu.Entities.Any(e => e is NumberEntity n && n.Value == 300))

            {

                return new AliceResponse

                {

                    Response = new ResponseBody

                    {

                        Text = "Отсоси у тракториста!",

                        /* обходим цензуру :) */

                        Tts = "xxx <[schwa t s schwa ss ii]> у тракториста! "

                    }

                };

            }

            else

            {

                return new AliceResponse

                {

                    Response = new ResponseBody

                    {

                        Text = "Ну скажи триста..."

                    }

                };

            }

        }

    }

}

```

Можно и просто использовать библиотеку со своим веб-сервером, используя её для сериализации и десериализации запросов и ответов. Для этого используется `System.Text.Json`.

## Поддержать

* [Buy Me A Coffee](https://www.buymeacoffee.com/cluster)

* [Donation Alerts](https://www.donationalerts.com/r/clustermeerkat)

* [Boosty](https://boosty.to/cluster)