Kısa mesaj gönderme ve alma

Makale
05/02/2024

ŞUNLAR IÇIN GEÇERLIDIR: SDK v4

Botunuzun kullanıcılarla iletişim kurmasının ve benzer şekilde iletişim almasının birincil yolu ileti etkinlikleridir. Bazı iletiler yalnızca düz metin, bazıları ise kartlar veya ekler gibi daha zengin içerik içerebilir. Botunuzun sıra işleyicisi kullanıcıdan iletiler alır ve oradan kullanıcıya yanıt gönderebilirsiniz. Dönüş bağlamı nesnesi, kullanıcıya ileti göndermek için yöntemler sağlar. Bu makalede düz metin iletileri gönderme açıklanmaktadır.

Markdown çoğu metin alanında desteklenir, ancak destek kanala göre farklılık gösterebilir.

Çalışan bir botun ileti gönderip alması için içindekiler tablosunun en üstündeki hızlı başlangıçları izleyin veya botların nasıl çalıştığına ilişkin makaleye göz atın. Bu makale, kendi kendinize çalıştırabileceğiniz örneklere de bağlantı sağlar.

Not

Bot Framework JavaScript, C# ve Python SDK'ları desteklenmeye devam edecektir, ancak Java SDK'sı son uzun vadeli destek Kasım 2023'te sona erecek şekilde kullanımdan kaldırılacaktır.

Java SDK ile oluşturulan mevcut botlar çalışmaya devam edecektir.

Yeni bot derlemesi için Power Virtual Agents'ı kullanmayı göz önünde bulundurun ve doğru sohbet botu çözümünü seçme hakkında bilgi edinin.

Daha fazla bilgi için bkz . Bot oluşturmanın geleceği.

Kısa mesaj gönder

Kısa mesaj göndermek için etkinlik olarak göndermek istediğiniz dizeyi belirtin:

Bot'un etkinlik işleyicilerinde, tek bir ileti yanıtı göndermek için turn bağlam nesnesinin SendActivityAsync yöntemini kullanın. Aynı anda birden çok yanıt göndermek için nesnenin SendActivitiesAsync yöntemini de kullanabilirsiniz.

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

Bot'un etkinlik işleyicilerinde, tek bir ileti yanıtı göndermek için turn bağlam nesnesinin sendActivity yöntemini kullanın. Aynı anda birden çok yanıt göndermek için nesnenin sendActivities yöntemini de kullanabilirsiniz.

await context.sendActivity("Welcome!");

turnContext.sendActivity("Welcome!");

Bot'un etkinlik işleyicilerinde, tek bir ileti yanıtı göndermek için turn bağlam nesnesinin send_activity yöntemini kullanın.

await turn_context.send_activity("Welcome!")

Dil Oluşturma (LG), birleştirme ve genişletme için kullanılan bir veya daha fazla metin varyasyonu içeren şablonlar sağlar. Sağlanan varyasyonlardan biri LG sistemi tarafından rastgele seçilecektir.

Aşağıdaki örnekte iki çeşitleme içeren bir bot yanıt şablonu gösterilmektedir.

# GreetingPrefix
- Hi
- Hello

Kısa mesaj alma

Bir metin iletisini işlemek için etkinlik nesnesinin text özelliğini kullanın.

Bot'un etkinlik işleyicilerinde bir ileti almak için aşağıdaki kodu kullanın.

var responseMessage = turnContext.Activity.Text;

Bot'un etkinlik işleyicilerinde bir ileti almak için aşağıdaki kodu kullanın.

let text = turnContext.activity.text;

Bot'un etkinlik işleyicilerinde bir ileti almak için aşağıdaki kodu kullanın.

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

Bot'un etkinlik işleyicilerinde bir ileti almak için aşağıdaki kodu kullanın.

response = context.activity.text

İleti almak için .lg dosyanıza aşağıdaki LG şablonunu ekleyin.

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

Yazma göstergesi gönderme

Kullanıcılar iletilerine zamanında yanıt bekler. Botunuz, kullanıcıya botu duyduğuna dair bir gösterge vermeden sunucu çağırma veya sorgu yürütme gibi uzun süre çalışan bir görev gerçekleştirirse, kullanıcı sabırsızlanabilir ve ek iletiler gönderebilir veya botunun bozuk olduğunu varsayabilir.

Web Sohbeti ve Direct Line kanal botları, kullanıcıya iletinin alındığını ve işlendiğini göstermek için bir yazma göstergesi gönderilmesini destekleyebilir. Ancak botunuzun 15 saniye içinde dönüşün sona ermesine izin vermeli, aksi takdirde Bağlan veya hizmet zaman aşımına uğrar. Daha uzun işlemler için proaktif iletiler gönderme hakkında daha fazla bilgi edinin.

Aşağıdaki örnek, yazma göstergesi göndermeyi gösterir.

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);
    }
}

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();
});

@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);
    }
}

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."
        )

# TypingIndicator
[Activity
    Type = typing
]

Ek kaynaklar

Sonraki adımlar

İletilere medya ekleme

Aracılığıyla paylaş

Kısa mesaj gönderme ve alma

Kısa mesaj gönder

Kısa mesaj alma

Yazma göstergesi gönderme

Ek kaynaklar

Sonraki adımlar

Ek kaynaklar