BotAdapter Sınıf
Oluşturucu
BotAdapter(on_turn_error: Callable[[TurnContext, Exception], Awaitable] = None)Parametreler
| Name | Description |
|---|---|
|
on_turn_error
|
Default value: None
|
Yöntemler
| continue_conversation |
Konuşmaya proaktif bir ileti gönderir. Bir konuşmaya proaktif olarak ileti göndermek için bu yöntemi çağırın. Çoğu kanal, bot kullanıcıya etkinlik göndermeden önce kullanıcının botla konuşma başlatmasını gerektirir. Tek kiracı Bağdaştırıcılar (Konsol, Test vb.) ancak çok kiracılı olan BotFrameworkAdapter için kritik öneme sahiptir. :p aram başvurusu: Devam etmek için konuşmaya yapılan başvuru. :type reference: ConversationReference :p aram geri çağırma: Sonuçta elde edilen bot dönüşü için çağrılacak yöntem. :type callback: Callable :p aram claims_identity: Konuşma için bir <xref:botframework.connector.auth.ClaimsIdentity>. :type claims_identity: <xref:botframework.connector.auth.ClaimsIdentity> :p aram audience:Proaktif iletinin alıcısını belirten değer. :type audience: str |
| create_conversation |
Bir kullanıcıyla yeni bir konuşma başlatır. İletiyi bir grubun üyesine yönlendirmek için kullanılır. |
| delete_activity |
Mevcut bir etkinliği siler. |
| run_pipeline |
Bağdaştırıcı ara yazılım kümesini çalıştırmak için üst sınıf tarafından çağrılır ve zincirin sonunda geçirilen callback() işleyicisini çağırır. |
| send_activities |
Kullanıcıya bir etkinlik kümesi gönderir. Sunucudan bir dizi yanıt döndürülür. |
| update_activity |
Var olan bir etkinliğin yerini alır. |
| use |
Bağdaştırıcıya bir ara yazılım işleyicisi kaydeder. |
continue_conversation
Konuşmaya proaktif bir ileti gönderir. Bir konuşmaya proaktif olarak ileti göndermek için bu yöntemi çağırın. Çoğu kanal, bot kullanıcıya etkinlik göndermeden önce kullanıcının botla konuşma başlatmasını gerektirir.
Tek kiracı Bağdaştırıcılar (Konsol, Test vb.) ancak çok kiracılı olan BotFrameworkAdapter için kritik öneme sahiptir. :p aram başvurusu: Devam etmek için konuşmaya yapılan başvuru. :type reference: ConversationReference :p aram geri çağırma: Sonuçta elde edilen bot dönüşü için çağrılacak yöntem. :type callback: Callable :p aram claims_identity: Konuşma için bir <xref:botframework.connector.auth.ClaimsIdentity>. :type claims_identity: <xref:botframework.connector.auth.ClaimsIdentity> :p aram audience:Proaktif iletinin alıcısını belirten değer. :type audience: str
async continue_conversation(reference: ConversationReference, callback: Callable, bot_id: str = None, claims_identity: ClaimsIdentity = None, audience: str = None)Parametreler
| Name | Description |
|---|---|
|
bot_id
|
Botun uygulama kimliği. Bu parametre içinde yoksayılır Default value: None
|
|
reference
Gerekli
|
|
|
callback
Gerekli
|
|
|
claims_identity
|
Default value: None
|
|
audience
|
Default value: None
|
create_conversation
Bir kullanıcıyla yeni bir konuşma başlatır. İletiyi bir grubun üyesine yönlendirmek için kullanılır.
async create_conversation(reference: ConversationReference, logic: Callable[[TurnContext], Awaitable] = None, conversation_parameters: ConversationParameters = None, channel_id: str = None, service_url: str = None, credentials: AppCredentials = None)Parametreler
| Name | Description |
|---|---|
|
reference
Gerekli
|
Kiracıyı içeren konuşma başvurusu |
|
logic
|
Konuşmanın oluşturulması için kullanılacak mantık Default value: None
|
|
conversation_parameters
|
Konuşmayı oluşturmak için kullanılacak bilgiler Default value: None
|
|
channel_id
|
<xref:typing.str>
Kanalın kimliği. Default value: None
|
|
service_url
|
<xref:typing.str>
Kanalın hizmet URL'si uç noktası. Default value: None
|
|
credentials
|
<xref:botframework.connector.auth.AppCredentials>
Bot için uygulama kimlik bilgileri. Default value: None
|
Döndürülenler
| Tür | Description |
|---|---|
|
Yürütülmek üzere kuyruğa alınan çalışmayı temsil eden bir görev. |
Özel durumlar
| Tür | Description |
|---|---|
|
It raises a generic exception error.
|
Açıklamalar
Bir konuşma başlatmak için botunuzun bu kanaldaki hesap bilgilerini ve kullanıcının hesap bilgilerini bilmesi gerekir. Kanalların çoğu yalnızca doğrudan ileti (grup dışı) konuşma başlatmayı destekler. Bağdaştırıcı kanalda yeni bir konuşma oluşturmayı dener ve ardından ara yazılım işlem hattı aracılığıyla geri çağırma yöntemine bir konuşma güncelleştirme etkinliği gönderir. Belirtilen kullanıcılarla konuşma oluşturulursa, etkinliğin kimliği yeni konuşmanın kimliğini içerir.
delete_activity
Mevcut bir etkinliği siler.
abstract async delete_activity(context: TurnContext, reference: ConversationReference)Parametreler
| Name | Description |
|---|---|
|
context
Gerekli
|
Dönüş için bağlam nesnesi. |
|
reference
Gerekli
|
Silinecek etkinlik için konuşma başvurusu. |
run_pipeline
Bağdaştırıcı ara yazılım kümesini çalıştırmak için üst sınıf tarafından çağrılır ve zincirin sonunda geçirilen callback() işleyicisini çağırır.
async run_pipeline(context: TurnContext, callback: Callable[[TurnContext], Awaitable] = None)Parametreler
| Name | Description |
|---|---|
|
context
Gerekli
|
Dönüş için bağlam nesnesi. |
|
callback
|
Callable[[<xref:TurnContext>],<xref: Awaitable>]
İşlem hattının sonunda çalıştırılacak bir geri çağırma yöntemi. Default value: None
|
send_activities
Kullanıcıya bir etkinlik kümesi gönderir. Sunucudan bir dizi yanıt döndürülür.
abstract async send_activities(context: TurnContext, activities: List[Activity]) -> List[ResourceResponse]Parametreler
| Name | Description |
|---|---|
|
context
Gerekli
|
Dönüş için bağlam nesnesi. |
|
activities
Gerekli
|
List[<xref:Activity>]
Gönderilecek etkinlikler. |
update_activity
Var olan bir etkinliğin yerini alır.
abstract async update_activity(context: TurnContext, activity: Activity)Parametreler
| Name | Description |
|---|---|
|
context
Gerekli
|
Dönüş için bağlam nesnesi. |
|
activity
Gerekli
|
Yeni değiştirme etkinliği. |
use
Bağdaştırıcıya bir ara yazılım işleyicisi kaydeder.
use(middleware)Parametreler
| Name | Description |
|---|---|
|
middleware
Gerekli
|
Kaydedilecek ara yazılım. |
Öznitelikler
BOT_CALLBACK_HANDLER_KEY
BOT_CALLBACK_HANDLER_KEY = 'BotCallbackHandler'BOT_CONNECTOR_CLIENT_KEY
BOT_CONNECTOR_CLIENT_KEY = 'ConnectorClient'BOT_IDENTITY_KEY
BOT_IDENTITY_KEY = 'BotIdentity'BOT_OAUTH_SCOPE_KEY
BOT_OAUTH_SCOPE_KEY = 'botbuilder.core.BotAdapter.OAuthScope'