BotFrameworkAdapter Kelas

Referensi

Definisi

Ruang nama:: Microsoft.Bot.Builder

Rakitan:: Microsoft.Bot.Builder.dll

Paket:: Microsoft.Bot.Builder v4.18.1

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Perhatian

Use CloudAdapter instead.

Adaptor bot yang dapat menyambungkan bot ke titik akhir layanan.

[System.Obsolete("Use `CloudAdapter` instead.", false)]
public class BotFrameworkAdapter : Microsoft.Bot.Builder.BotAdapter, Microsoft.Bot.Builder.IExtendedUserTokenProvider, Microsoft.Bot.Builder.Integration.IAdapterIntegration, Microsoft.Bot.Builder.OAuth.IConnectorClientBuilder

[<System.Obsolete("Use `CloudAdapter` instead.", false)>]
type BotFrameworkAdapter = class
    inherit BotAdapter
    interface IAdapterIntegration
    interface IExtendedUserTokenProvider
    interface IUserTokenProvider
    interface IConnectorClientBuilder

Public Class BotFrameworkAdapter
Inherits BotAdapter
Implements IAdapterIntegration, IConnectorClientBuilder, IExtendedUserTokenProvider

Warisan: Object

BotAdapter
BotFrameworkAdapter

Turunan: Microsoft.Bot.Builder.Streaming.BotFrameworkHttpAdapterBase

Atribut: ObsoleteAttribute

Penerapan: IExtendedUserTokenProvider IAdapterIntegration IUserTokenProvider IConnectorClientBuilder

Keterangan

Adaptor bot merangkum proses autentikasi dan mengirim aktivitas ke dan menerima aktivitas dari Bot Connector Service. Saat bot Anda menerima aktivitas, adaptor membuat objek konteks, meneruskannya ke logika aplikasi bot Anda, dan mengirim respons kembali ke saluran pengguna.

Gunakan Use(IMiddleware) untuk menambahkan IMiddleware objek ke koleksi middleware adapter Anda. Adapter memproses dan mengarahkan aktivitas yang masuk melalui alur middleware bot ke logika bot Anda dan kembali keluar lagi. Saat setiap aktivitas mengalir masuk dan keluar dari bot, setiap bagian dari middleware dapat memeriksa atau bertindak atas aktivitas, baik sebelum dan sesudah logika bot berjalan.

Konstruktor

BotFrameworkAdapter(AppCredentials, AuthenticationConfiguration, IChannelProvider, RetryPolicy, HttpClient, IMiddleware, ILogger)	Kedaluwarsa. Menginisialisasi instans BotFrameworkAdapter baru kelas, menggunakan penyedia kredensial.
BotFrameworkAdapter(ICredentialProvider, AuthenticationConfiguration, IChannelProvider, RetryPolicy, HttpClient, IMiddleware, ILogger)	Kedaluwarsa. Menginisialisasi instans BotFrameworkAdapter baru kelas, menggunakan penyedia kredensial.
BotFrameworkAdapter(ICredentialProvider, IChannelProvider, RetryPolicy, HttpClient, IMiddleware, ILogger)	Kedaluwarsa. Menginisialisasi instans BotFrameworkAdapter baru kelas, menggunakan penyedia kredensial.

Bidang

BotIdentityKey	Kedaluwarsa. Nilai string untuk kunci identitas bot. (Diperoleh dari BotAdapter)
InvokeResponseKey	Kedaluwarsa. Nilai kunci untuk InvokeResponseActivity apa pun yang akan berada di TurnState. (Diperoleh dari BotAdapter)
OAuthScopeKey	Kedaluwarsa. Nilai string untuk kunci cakupan OAuth. (Diperoleh dari BotAdapter)

Properti

AppCredentialMap	Kedaluwarsa. Mendapatkan peta aplikasi untuk AppCredentials adaptor ini.
ChannelProvider	Kedaluwarsa. Mendapatkan penyedia saluran untuk adaptor ini.
CredentialProvider	Kedaluwarsa. Mendapatkan penyedia kredensial untuk adaptor ini.
HttpClient	Kedaluwarsa. Mendapatkan kustom HttpClient untuk adaptor ini jika ditentukan.
Logger	Kedaluwarsa. Mendapatkan pencatat untuk adaptor ini.
MiddlewareSet	Kedaluwarsa. Mendapatkan koleksi middleware di alur adaptor. (Diperoleh dari BotAdapter)
OnTurnError	Kedaluwarsa. Mendapatkan atau mengatur handler kesalahan yang dapat menangkap pengecualian di middleware atau aplikasi. (Diperoleh dari BotAdapter)

Metode

BuildCredentialsAsync(String, String)	Kedaluwarsa. Logika untuk membangun objek yang AppCredentials akan digunakan untuk memperoleh token untuk HttpClient ini.
CanProcessOutgoingActivity(Activity)	Kedaluwarsa. Kesempatan bagi subkelas untuk ikut serta memproses aktivitas keluar.
ContinueConversationAsync(ClaimsIdentity, Activity, BotCallbackHandler, CancellationToken)	Kedaluwarsa. Mengirim pesan proaktif ke percakapan. (Diperoleh dari BotAdapter)
ContinueConversationAsync(ClaimsIdentity, Activity, String, BotCallbackHandler, CancellationToken)	Kedaluwarsa. Mengirim pesan proaktif ke percakapan. (Diperoleh dari BotAdapter)
ContinueConversationAsync(ClaimsIdentity, ConversationReference, BotCallbackHandler, CancellationToken)	Kedaluwarsa. Mengirim pesan proaktif dari bot ke percakapan.
ContinueConversationAsync(ClaimsIdentity, ConversationReference, String, BotCallbackHandler, CancellationToken)	Kedaluwarsa. Mengirim pesan proaktif dari bot ke percakapan.
ContinueConversationAsync(String, Activity, BotCallbackHandler, CancellationToken)	Kedaluwarsa. Mengirim pesan proaktif ke percakapan. (Diperoleh dari BotAdapter)
ContinueConversationAsync(String, ConversationReference, BotCallbackHandler, CancellationToken)	Kedaluwarsa. Mengirim pesan proaktif dari bot ke percakapan.
CreateConversationAsync(String, String, AppCredentials, ConversationParameters, BotCallbackHandler, CancellationToken)	Kedaluwarsa. Membuat percakapan pada saluran yang ditentukan.
CreateConversationAsync(String, String, AppCredentials, ConversationParameters, BotCallbackHandler, ConversationReference, CancellationToken)	Kedaluwarsa. Membuat percakapan pada saluran yang ditentukan. Kelebihan beban menerima ConversationReference termasuk penyewa.
CreateConversationAsync(String, String, MicrosoftAppCredentials, ConversationParameters, BotCallbackHandler, CancellationToken)	Kedaluwarsa. Membuat percakapan pada saluran yang ditentukan.
CreateConversationAsync(String, String, MicrosoftAppCredentials, ConversationParameters, BotCallbackHandler, ConversationReference, CancellationToken)	Kedaluwarsa. Membuat percakapan pada saluran yang ditentukan. Kelebihan beban menerima ConversationReference termasuk penyewa.
CreateConversationAsync(String, String, String, String, ConversationParameters, BotCallbackHandler, CancellationToken)	Kedaluwarsa. Membuat percakapan pada saluran yang ditentukan. (Diperoleh dari BotAdapter)
CreateOAuthApiClientAsync(ITurnContext)	Kedaluwarsa. Membuat klien OAuth untuk bot.
CreateOAuthApiClientAsync(ITurnContext, AppCredentials)	Kedaluwarsa. Membuat klien OAuth untuk bot dengan kredensial.
DeleteActivityAsync(ITurnContext, ConversationReference, CancellationToken)	Kedaluwarsa. Menghapus aktivitas yang sudah ada dalam percakapan.
DeleteConversationMemberAsync(ITurnContext, String, CancellationToken)	Kedaluwarsa. Menghapus anggota dari percakapan saat ini.
ExchangeTokenAsync(ITurnContext, AppCredentials, String, String, TokenExchangeRequest, CancellationToken)	Kedaluwarsa. Melakukan operasi pertukaran token seperti untuk akses menyeluruh.
ExchangeTokenAsync(ITurnContext, String, String, TokenExchangeRequest, CancellationToken)	Kedaluwarsa. Melakukan operasi pertukaran token seperti untuk akses menyeluruh.
GetAadTokensAsync(ITurnContext, AppCredentials, String, String[], String, CancellationToken)	Kedaluwarsa. Mengambil token Azure Active Directory untuk sumber daya tertentu pada koneksi yang dikonfigurasi, menggunakan AppCredentials yang disesuaikan.
GetAadTokensAsync(ITurnContext, String, String[], String, CancellationToken)	Kedaluwarsa. Mengambil token Azure Active Directory untuk sumber daya tertentu pada koneksi yang dikonfigurasi, menggunakan AppCredentials bot.
GetActivityMembersAsync(ITurnContext, String, CancellationToken)	Kedaluwarsa. Mencantumkan anggota aktivitas tertentu.
GetConversationMembersAsync(ITurnContext, CancellationToken)	Kedaluwarsa. Mencantumkan anggota percakapan saat ini.
GetConversationsAsync(ITurnContext, String, CancellationToken)	Kedaluwarsa. Mencantumkan Percakapan di mana bot ini telah berpartisipasi untuk server saluran tertentu. Server saluran mengembalikan hasil di halaman dan setiap halaman akan menyertakan `continuationToken` yang dapat digunakan untuk mengambil halaman hasil berikutnya dari server.
GetConversationsAsync(String, MicrosoftAppCredentials, String, CancellationToken)	Kedaluwarsa. Mencantumkan Percakapan di mana bot ini telah berpartisipasi untuk server saluran tertentu. Server saluran mengembalikan hasil di halaman dan setiap halaman akan menyertakan `continuationToken` yang dapat digunakan untuk mengambil halaman hasil berikutnya dari server.
GetOauthSignInLinkAsync(ITurnContext, AppCredentials, String, CancellationToken)	Kedaluwarsa. Dapatkan tautan masuk mentah yang akan dikirim ke pengguna untuk masuk untuk nama koneksi, menggunakan AppCredentials yang disesuaikan.
GetOauthSignInLinkAsync(ITurnContext, AppCredentials, String, String, String, CancellationToken)	Kedaluwarsa. Dapatkan tautan masuk mentah yang akan dikirim ke pengguna untuk masuk untuk nama koneksi, menggunakan AppCredentials yang disesuaikan.
GetOauthSignInLinkAsync(ITurnContext, String, CancellationToken)	Kedaluwarsa. Dapatkan tautan masuk mentah yang akan dikirim ke pengguna untuk masuk untuk nama koneksi, menggunakan AppCredentials bot.
GetOauthSignInLinkAsync(ITurnContext, String, String, String, CancellationToken)	Kedaluwarsa. Dapatkan tautan masuk mentah yang akan dikirim ke pengguna untuk masuk untuk nama koneksi, menggunakan AppCredentials bot.
GetSignInResourceAsync(ITurnContext, AppCredentials, String, String, String, CancellationToken)	Kedaluwarsa. Dapatkan tautan masuk mentah untuk dikirim ke pengguna untuk masuk untuk nama koneksi.
GetSignInResourceAsync(ITurnContext, String, CancellationToken)	Kedaluwarsa. Dapatkan tautan masuk mentah untuk dikirim ke pengguna untuk masuk untuk nama koneksi.
GetSignInResourceAsync(ITurnContext, String, String, String, CancellationToken)	Kedaluwarsa. Dapatkan tautan masuk mentah untuk dikirim ke pengguna untuk masuk untuk nama koneksi.
GetTokenStatusAsync(ITurnContext, AppCredentials, String, String, CancellationToken)	Kedaluwarsa. Mengambil status token untuk setiap koneksi yang dikonfigurasi untuk pengguna tertentu, menggunakan AppCredentials yang disesuaikan.
GetTokenStatusAsync(ITurnContext, String, String, CancellationToken)	Kedaluwarsa. Mengambil status token untuk setiap koneksi yang dikonfigurasi untuk pengguna tertentu, menggunakan AppCredentials bot.
GetUserTokenAsync(ITurnContext, AppCredentials, String, String, CancellationToken)	Kedaluwarsa. Mencoba mengambil token untuk pengguna yang berada dalam alur masuk, menggunakan AppCredentials yang disesuaikan.
GetUserTokenAsync(ITurnContext, String, String, CancellationToken)	Kedaluwarsa. Mencoba mengambil token untuk pengguna yang berada dalam alur masuk, menggunakan AppCredentials bot.
ProcessActivityAsync(ClaimsIdentity, Activity, BotCallbackHandler, CancellationToken)	Kedaluwarsa. Membuat konteks giliran dan menjalankan alur middleware untuk aktivitas masuk.
ProcessActivityAsync(String, Activity, BotCallbackHandler, CancellationToken)	Kedaluwarsa. Membuat konteks giliran dan menjalankan alur middleware untuk aktivitas masuk.
ProcessOutgoingActivityAsync(ITurnContext, Activity, CancellationToken)	Kedaluwarsa. Logika kustom untuk mengirim aktivitas keluar. Subkelas dapat mengambil alih metode ini bersama dengan CanProcessOutgoingActivity untuk memiliki logika kustom untuk memproses aktivitas keluar.
RunPipelineAsync(ITurnContext, BotCallbackHandler, CancellationToken)	Kedaluwarsa. Memulai pemrosesan aktivitas untuk giliran bot saat ini. (Diperoleh dari BotAdapter)
SendActivitiesAsync(ITurnContext, Activity[], CancellationToken)	Kedaluwarsa. Mengirim aktivitas ke percakapan.
SignOutUserAsync(ITurnContext, AppCredentials, String, String, CancellationToken)	Kedaluwarsa. Mengeluarkan pengguna dengan server token, menggunakan AppCredentials yang disesuaikan.
SignOutUserAsync(ITurnContext, String, String, CancellationToken)	Kedaluwarsa. Mengeluarkan pengguna dengan server token, menggunakan AppCredentials bot.
UpdateActivityAsync(ITurnContext, Activity, CancellationToken)	Kedaluwarsa. Mengganti aktivitas yang sudah ada dalam percakapan.
Use(IMiddleware)	Kedaluwarsa. Menambahkan middleware ke alur adaptor.

Implementasi Antarmuka Eksplisit

IConnectorClientBuilder.CreateConnectorClientAsync(String, ClaimsIdentity, String, CancellationToken)

Kedaluwarsa.

Adaptor bot yang dapat menyambungkan bot ke titik akhir layanan.

Metode Ekstensi

UseBotState(BotAdapter, BotState[])	Kedaluwarsa. Menambahkan middleware ke adaptor untuk mendaftarkan satu atau beberapa BotState objek pada konteks giliran. Middleware mendaftarkan objek status pada konteks giliran di awal setiap giliran.
UseState(BotAdapter, UserState, ConversationState, Boolean)	Kedaluwarsa. Mendaftarkan objek status pengguna dan percakapan dengan adaptor. Objek-objek ini akan tersedia melalui metode .Get<T>() konteks TurnStategiliran.
UseStorage(BotAdapter, IStorage)	Kedaluwarsa. Menambahkan middleware ke adaptor untuk mendaftarkan IStorage objek pada konteks giliran. Middleware mendaftarkan objek status pada konteks giliran di awal setiap giliran.

Berlaku untuk

Bagikan melalui