Odesílání a příjem textových zpráv

PLATÍ PRO: SDK v4

Primární způsob, jakým robot bude komunikovat s uživateli a podobně přijímá komunikaci, je prostřednictvím aktivit zpráv . Některé zprávy můžou obsahovat jenom prostý text, zatímco jiné můžou obsahovat bohatší obsah, například karty nebo přílohy. Obslužná rutina otáčení robota přijímá zprávy od uživatele a od uživatele můžete odesílat odpovědi. Objekt kontextu otáčení poskytuje metody pro odesílání zpráv zpět uživateli. Tento článek popisuje, jak odesílat zprávy ve formátu prostého textu.

Markdown je podporovaný pro většinu textových polí, ale podpora se může lišit podle kanálu.

Pokud chcete, aby robot odesílal a přijímal zprávy, postupujte podle rychlých startů v horní části obsahu nebo si projděte článek o tom, jak roboti fungují, a odkazy na ukázky, které můžete spustit sami.

Poznámka:

Sady SDK služby Bot Framework JavaScript, C# a Python budou nadále podporovány, ale sada Java SDK se vyřazuje s konečnou dlouhodobou podporou končící v listopadu 2023.

Stávající roboti sestavení pomocí sady Java SDK budou i nadále fungovat.

Pro nové vytváření robotů zvažte použití Power Virtual Agents a přečtěte si o výběru správného řešení chatovacího robota.

Další informace najdete v tématu Budoucnost vytváření robotů.

Odeslat textovou zprávu

Pokud chcete odeslat textovou zprávu, zadejte řetězec, který chcete odeslat jako aktivitu:

C#

V obslužných rutinách aktivit robota použijte metodu kontextového SendActivityAsync objektu turn k odeslání jedné odpovědi na zprávu. Můžete také použít metodu objektu SendActivitiesAsync k odeslání více odpovědí najednou.

await turnContext.SendActivityAsync($"Welcome!");

JavaScript

V obslužných rutinách aktivit robota použijte metodu kontextového sendActivity objektu turn k odeslání jedné odpovědi na zprávu. Můžete také použít metodu objektu sendActivities k odeslání více odpovědí najednou.

await context.sendActivity("Welcome!");

Java

V obslužných rutinách aktivit robota použijte metodu kontextového sendActivity objektu turn k odeslání jedné odpovědi na zprávu. Můžete také použít metodu objektu sendActivities k odeslání více odpovědí najednou.

turnContext.sendActivity("Welcome!");

Python

V obslužných rutinách aktivit robota použijte metodu kontextového send_activity objektu turn k odeslání jedné odpovědi na zprávu.

await turn_context.send_activity("Welcome!")

LG

Jazyková generace (LG) poskytuje šablony, které obsahují jednu nebo více variant textu, které se používají ke složení a rozšíření. Jeden z nabízených variant bude náhodně vybrán systémem LG.

Následující příklad ukazuje šablonu odpovědi robota, která obsahuje dvě varianty.

# GreetingPrefix
- Hi
- Hello

Přijetí textové zprávy

Pokud chcete zpracovat textovou zprávu, použijte textovou vlastnost objektu aktivity .

C#

V obslužných rutinách aktivit robota použijte následující kód k přijetí zprávy.

var responseMessage = turnContext.Activity.Text;

JavaScript

V obslužných rutinách aktivit robota použijte následující kód k přijetí zprávy.

let text = turnContext.activity.text;

Java

V obslužných rutinách aktivit robota použijte následující kód k přijetí zprávy.

String responseMessage = turnContext.getActivity().getText();

Python

V obslužných rutinách aktivit robota použijte následující kód k přijetí zprávy.

response = context.activity.text

LG

Přidejte následující šablonu LG do souboru .lg, aby se zobrazila zpráva.

# EchoMessage
You said '${turn.activity.text}'

Odeslání indikátoru psaní

Uživatelé očekávají včasnou odpověď na své zprávy. Pokud robot provádí určitou dlouhou úlohu, jako je volání serveru nebo provádění dotazu, aniž by uživateli poskytl nějaké informace o tom, že ho robot zaslechl, mohl by dostat netrpělivý a odeslat další zprávy nebo jen předpokládat, že je robot poškozený.

Webový chat a roboti kanálu Direct Line můžou podporovat odesílání informací o psaní, aby uživateli ukázali, že zpráva byla přijata a zpracována. Robot ale musí nechat koncový bod do 15 sekund, jinak vyprší časový limit služby Připojení oru. V případě delších procesů si přečtěte další informace o odesílání proaktivních zpráv.

Následující příklad ukazuje, jak odeslat indikaci psaní.

C#

protected override async Task OnMessageActivityAsync(ITurnContext<IMessageActivity> turnContext, CancellationToken cancellationToken)
{
    if (string.Equals(turnContext.Activity.Text, "wait", System.StringComparison.InvariantCultureIgnoreCase))
    {
        await turnContext.SendActivitiesAsync(
            new Activity[] {
                new Activity { Type = ActivityTypes.Typing },
                new Activity { Type = "delay", Value= 3000 },
                MessageFactory.Text("Finished typing", "Finished typing"),
            },
            cancellationToken);
    }
    else
    {
        var replyText = $"Echo: {turnContext.Activity.Text}. Say 'wait' to watch me type.";
        await turnContext.SendActivityAsync(MessageFactory.Text(replyText, replyText), cancellationToken);
    }
}

JavaScript

this.onMessage(async (context, next) => {
    if (context.activity.text === 'wait') {
        await context.sendActivities([
            { type: ActivityTypes.Typing },
            { type: 'delay', value: 3000 },
            { type: ActivityTypes.Message, text: 'Finished typing' }
        ]);
    } else {
        await context.sendActivity(`You said '${ context.activity.text }'. Say "wait" to watch me type.`);
    }
    await next();
});

Java

@Override
protected CompletableFuture<Void> onMessageActivity(TurnContext turnContext) {
    if (turnContext.getActivity().getText().toLowerCase().equals("wait")) {
        List<Activity> activities = new ArrayList<Activity>();
        activities.add(new Activity(ActivityTypes.TYPING));
        activities.add(new Activity(ActivityTypes.DELAY) {{setValue(3000);}});
        activities.add(MessageFactory.text("Finished typing", "Finished typing", null));
        return turnContext.sendActivities(activities).thenApply(result -> null);
    } else {

        return turnContext.sendActivity(MessageFactory.text("Echo: " + turnContext.getActivity().getText()))
            .thenApply(sendResult -> null);
    }
}

Python

async def on_message_activity(self, turn_context: TurnContext):
    if turn_context.activity.text == "wait":
        return await turn_context.send_activities([
            Activity(
                type=ActivityTypes.typing
            ),
            Activity(
                type="delay",
                value=3000
            ),
            Activity(
                type=ActivityTypes.message,
                text="Finished Typing"
            )
        ])
    else:
        return await turn_context.send_activity(
            f"You said {turn_context.activity.text}.  Say 'wait' to watch me type."
        )

LG

# TypingIndicator
[Activity
    Type = typing
]

Další materiály

• Zpracování aktivit
• Oddíl Aktivity zpráv
• Generování jazyka

Další kroky

Přidání média do zpráv