W ostatnim odcinku pokrótce wprowadziłem Was do systemu Bot Buildera w ramach Bot Frameworka, dzisiaj pokażę jak w praktyce wygląda implementacja konwersacji opartych o system dialogów Bot Buildera. Zapraszam!

Pierwszą rzeczą, jaką musimy zmienić w projekcie, aby korzystać z dialogów jest wywołanie w kontrolerze „punktu wejścia” do systemu dialogów, robi się to tak:

public async Task<HttpResponseMessage> Post([FromBody]Activity activity)
{
    if (activity.Type == ActivityTypes.Message)
        await Conversation.SendAsync(activity, () => new SampleDialog());
    else
        HandleSystemMessage(activity);
    
    return Request.CreateResponse(HttpStatusCode.OK);
}

Czwarta linijka powoduje przesłanie otrzymanego activity do systemu dialogów. Jednocześnie, jako drugi argument podajemy funkcję tworzącą domyślny dialog, jeśli takowy nie istnieje dla obecnej konwersacji.

Przy tej okazji polecam także implementację wiadomości powitalnej oraz inicjalizację systemu dialogów tuż po otrzymaniu informacji o dołączeniu do rozmowy – dzięki temu unikniemy nieco kłopotliwego przetwarzania pierwszej wiadomości w ramach nowozainicjalizowanego dialogu głównego:

private async Task<Activity> HandleSystemMessage(Activity activity, ConnectorClient connector)
{
    switch (activity.Type)
    {
        // usunięta reszta przykładowego kodu, żeby nie zajmowała miejsca
        
        case ActivityTypes.ConversationUpdate:
            if (activity.MembersAdded.Any() && activity.MembersAdded[0].Name != "Bot")
            {
               await connector.Conversations.ReplyToActivityAsync(activity.CreateReply($"Cześć, {activity.MembersAdded[0].Name}!"));         
               await Conversation.SendAsync(activity, () => new SampleDialog());
            }
            break;
    }

    return null;
}

Każdy dialog musi implementować interfejs IDialog<T> zawierający jedną metodę: Task StartAsync(IDialogContext context) – to do tej metody przekazywana jest kontrola w programie, gdy tylko bot otrzyma nową wiadomość. Minimalny dialog wygląda więc tak:

[Serializable]
public class SampleDialog : IDialog<object>
{
    public Task StartAsync(IDialogContext context)
    {
        throw new NotImplementedException();
    }
}

Atrybut Serializable jest kluczowy do działania, gdyż Bot Builder po przetworzeniu otrzymanej wiadomości serializuje cały dialog stack, aby przy następnej otrzymanej wiadomości go zdeserializować, przywrócić sterowanie w ostatnim miejscu na którym zakończył przetwarzanie oraz przekazać w to miejsce nową wiadomość.

Serializacja dialogów

Oznacza to nie mniej i nie więcej, że możemy spokojnie używać pól oraz properties klasy między kolejnymi wiadomościami – zostaną one automatycznie zachowane. Prześledźmy przykładową implementację, która pyta użytkownika o imię i miasto:

[Serializable]
public class SampleDialog : IDialog<object>
{
    private string _name;
    private string _city;

    public Task StartAsync(IDialogContext context)
    {
        context.Wait(MessageReceivedAsync);

        return Task.CompletedTask;
    }

    private async Task MessageReceivedAsync(IDialogContext context, IAwaitable<IMessageActivity> result)
    {
        await result;

        await context.PostAsync("Jak masz na imię?");

        context.Wait(OnNameProvided);
    }
    
    private async Task OnNameProvided(IDialogContext context, IAwaitable<IMessageActivity> result)
    {
        _name = (await result).Text;

        await context.PostAsync("W jakim mieście mieszkasz?");

        context.Wait(OnCityProvided);
    }

    private async Task OnCityProvided(IDialogContext context, IAwaitable<IMessageActivity> result)
    {
        _city = (await result).Text;

        await context.PostAsync($"Witaj {_name} z miasta {_city}!");
    }
}

Powyższa implementacja w rezultacie pozwala na przeprowadzenie następującej rozmowy:

To co jest fajne w tym rozwiązaniu to brak konieczności używania zewnętrznego magazynu na proste dane zbierane w ramach pojedynczego dialogu. Niestety, konieczność serializacji wszystkich dialogów to także problemy, o których pisałem ostatnio.

W następnych częściach…

… pokażę jak wykonywać przejścia między dialogami, dzięki którym możliwe jest m.in. wydzielenie wspólnych komponentów i ich reużywanie w wielu projektach, a także jak rozwiązać kwestię serializacji dialogów w kontekście wstrzykiwania zależności.

A później przejdziemy do sztucznej inteligencji w zastosowaniach związanych z chatbotami :)

Aby nie przegapić kolejnych wpisów zapraszam do śledzenia tego bloga, czy to przez kanał RSS, czy też poprzez stronę na Facebooku.