Szöveges üzenetek küldése és fogadása

A KÖVETKEZŐKRE VONATKOZIK: SDK v4

A robot elsődleges kommunikációja a felhasználókkal, valamint a kommunikáció fogadása az üzenettevékenységeken keresztül történik. Egyes üzenetek csak egyszerű szöveget tartalmazhatnak, míg mások gazdagabb tartalmakat, például kártyákat vagy mellékleteket tartalmazhatnak. A robot kezelője üzeneteket fogad a felhasználótól, és onnan is küldhet válaszokat a felhasználónak. A turn context objektum metódusokat biztosít az üzenetek felhasználónak való visszaküldéséhez. Ez a cikk azt ismerteti, hogyan küldhet egyszerű szöveges üzeneteket.

A Markdown a legtöbb szövegmező esetében támogatott, de a támogatás csatornánként eltérő lehet.

Ha egy futó robot üzeneteket küld és fogad, kövesse a tartalomjegyzék tetején található rövid útmutatókat, vagy tekintse meg a robotok működéséről szóló cikket, amely a saját futtatásához elérhető mintákra mutató hivatkozásokat is tartalmaz.

Feljegyzés

A Bot Framework JavaScript, C# és Python SDK-k továbbra is támogatottak lesznek, a Java SDK-t azonban 2023 novemberében végső hosszú távú támogatással kivonják.

A Java SDK-val létrehozott meglévő robotok továbbra is működni fognak.

Új robotépítéshez fontolja meg a Power Virtual Agents használatát, és olvassa el a megfelelő csevegőrobot-megoldás kiválasztását.

További információ: A robotépítés jövője.

Szöveges üzenet küldése

Szöveges üzenet küldéséhez adja meg a tevékenységként elküldeni kívánt sztringet:

C#

A robot tevékenységkezelőiben a turn context objektum metódusával SendActivityAsync küldjön egyetlen üzenetválaszt. Az objektum metódusával SendActivitiesAsync egyszerre több választ is küldhet.

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

JavaScript

A robot tevékenységkezelőiben a turn context objektum metódusával sendActivity küldjön egyetlen üzenetválaszt. Az objektum metódusával sendActivities egyszerre több választ is küldhet.

await context.sendActivity("Welcome!");

Java

A robot tevékenységkezelőiben a turn context objektum metódusával sendActivity küldjön egyetlen üzenetválaszt. Az objektum metódusával sendActivities egyszerre több választ is küldhet.

turnContext.sendActivity("Welcome!");

Python

A robot tevékenységkezelőiben a turn context objektum metódusával send_activity küldjön egyetlen üzenetválaszt.

await turn_context.send_activity("Welcome!")

LG

A Language Generation (LG) olyan sablonokat biztosít, amelyek egy vagy több szövegváltozatot tartalmaznak, amelyeket az összeállításhoz és a bővítéshez használnak. A megadott változatok egyikét véletlenszerűen választja ki az LG rendszer.

Az alábbi példa egy robotválaszsablont mutat be, amely két változatot tartalmaz.

# GreetingPrefix
- Hi
- Hello

Szöveges üzenet fogadása

Szöveges üzenet kezeléséhez használja a tevékenységobjektum szöveges tulajdonságát.

C#

A robot tevékenységkezelőiben az alábbi kód használatával fogadjon üzenetet.

var responseMessage = turnContext.Activity.Text;

JavaScript

A robot tevékenységkezelőiben az alábbi kód használatával fogadjon üzenetet.

let text = turnContext.activity.text;

Java

A robot tevékenységkezelőiben az alábbi kód használatával fogadjon üzenetet.

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

Python

A robot tevékenységkezelőiben az alábbi kód használatával fogadjon üzenetet.

response = context.activity.text

LG

Az üzenet fogadásához adja hozzá az alábbi LG-sablont az .lg fájlhoz.

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

Gépelésjelző küldése

A felhasználók időben válaszolnak az üzeneteikre. Ha a robot olyan hosszú ideig futó feladatot hajt végre, mint a kiszolgáló hívása vagy a lekérdezés végrehajtása anélkül, hogy a felhasználónak jelzést adna arról, hogy a robot hallotta őket, a felhasználó türelmetlen lehet, és további üzeneteket küldhet, vagy csak feltételezheti, hogy a robot meghibásodott.

webchat és a Direct Line csatornarobotjai támogatják a gépelés jelzésének küldését, amely megmutatja a felhasználónak az üzenet fogadását és feldolgozását. A robotnak azonban 15 másodpercen belül véget kell vetnie a fordulónak, különben a Csatlakozás or szolgáltatás időtúllépést fog végrehajtani. A hosszabb folyamatokról további információ a proaktív üzenetek küldéséről.

Az alábbi példa bemutatja, hogyan küldhet be gépelési jelzést.

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
]

További erőforrások

• Tevékenységfeldolgozás
• Üzenettevékenység szakasz
• Nyelvlétrehozás

Következő lépések

Média hozzáadása üzenetekhez