다음을 통해 공유


BotFrameworkAdapter 클래스

정의

서비스 엔드포인트에 봇을 연결할 수 있는 봇 어댑터입니다.

public class BotFrameworkAdapter : Microsoft.Bot.Builder.BotAdapter, Microsoft.Bot.Builder.IExtendedUserTokenProvider, Microsoft.Bot.Builder.Integration.IAdapterIntegration, Microsoft.Bot.Builder.OAuth.IConnectorClientBuilder
type BotFrameworkAdapter = class
    inherit BotAdapter
    interface IAdapterIntegration
    interface IExtendedUserTokenProvider
    interface IUserTokenProvider
    interface IConnectorClientBuilder
Public Class BotFrameworkAdapter
Inherits BotAdapter
Implements IAdapterIntegration, IConnectorClientBuilder, IExtendedUserTokenProvider
상속
BotFrameworkAdapter
파생
구현

설명

BotFrameworkAdapter는 여전히 지원되지만 권장되는 어댑터는 'CloudAdapter'입니다. 봇 어댑터는 인증 프로세스를 캡슐화하고 Bot Connector Service에서 활동을 보내고 받습니다. 봇이 작업을 받으면 어댑터는 컨텍스트 개체를 만들고, 봇의 애플리케이션 논리에 전달하고, 응답을 사용자의 채널로 다시 보냅니다.

Use(IMiddleware) 사용하여 어댑터의 미들웨어 컬렉션에 IMiddleware 개체를 추가합니다. 어댑터는 봇 미들웨어 파이프라인을 통해 들어오는 작업을 처리하고 봇의 논리로 전달한 다음 다시 내보낼 수 있습니다. 각 활동이 봇 내/외부로 흐르면 미들웨어의 각 조각은 봇 논리 실행 전후에 작업을 검사하거나 작업할 수 있습니다.

생성자

BotFrameworkAdapter(AppCredentials, AuthenticationConfiguration, IChannelProvider, RetryPolicy, HttpClient, IMiddleware, ILogger)

자격 증명 공급자를 사용하여 BotFrameworkAdapter 클래스의 새 인스턴스를 초기화합니다.

BotFrameworkAdapter(ICredentialProvider, AuthenticationConfiguration, IChannelProvider, RetryPolicy, HttpClient, IMiddleware, ILogger)

자격 증명 공급자를 사용하여 BotFrameworkAdapter 클래스의 새 인스턴스를 초기화합니다.

BotFrameworkAdapter(ICredentialProvider, IChannelProvider, RetryPolicy, HttpClient, IMiddleware, ILogger)

자격 증명 공급자를 사용하여 BotFrameworkAdapter 클래스의 새 인스턴스를 초기화합니다.

필드

BotIdentityKey

봇 ID 키의 문자열 값입니다.

(다음에서 상속됨 BotAdapter)
InvokeResponseKey

TurnState에 있을 InvokeResponseActivity의 키 값입니다.

(다음에서 상속됨 BotAdapter)
OAuthScopeKey

OAuth 범위 키의 문자열 값입니다.

(다음에서 상속됨 BotAdapter)

속성

AppCredentialMap

이 어댑터에 대해 AppCredentials 애플리케이션의 맵을 가져옵니다.

ChannelProvider

이 어댑터의 채널 공급자를 가져옵니다.

CredentialProvider

이 어댑터의 자격 증명 공급자를 가져옵니다.

HttpClient

지정한 경우 이 어댑터에 대한 사용자 지정 HttpClient 가져옵니다.

Logger

이 어댑터의 로거를 가져옵니다.

MiddlewareSet

어댑터 파이프라인의 미들웨어 컬렉션을 가져옵니다.

(다음에서 상속됨 BotAdapter)
OnTurnError

미들웨어 또는 애플리케이션에서 예외를 catch할 수 있는 오류 처리기를 가져오거나 설정합니다.

(다음에서 상속됨 BotAdapter)

메서드

BuildCredentialsAsync(String, String)

이 HttpClient에 대한 토큰을 획득하는 데 사용할 AppCredentials 개체를 빌드하는 논리입니다.

CanProcessOutgoingActivity(Activity)

서브클래스가 나가는 활동을 처리하도록 옵트인할 수 있는 기회입니다.

ContinueConversationAsync(ClaimsIdentity, Activity, BotCallbackHandler, CancellationToken)

대화에 자동 관리 메시지를 보냅니다.

(다음에서 상속됨 BotAdapter)
ContinueConversationAsync(ClaimsIdentity, Activity, String, BotCallbackHandler, CancellationToken)

대화에 자동 관리 메시지를 보냅니다.

(다음에서 상속됨 BotAdapter)
ContinueConversationAsync(ClaimsIdentity, ConversationReference, BotCallbackHandler, CancellationToken)

봇에서 대화로 자동 관리 메시지를 보냅니다.

ContinueConversationAsync(ClaimsIdentity, ConversationReference, String, BotCallbackHandler, CancellationToken)

봇에서 대화로 자동 관리 메시지를 보냅니다.

ContinueConversationAsync(String, Activity, BotCallbackHandler, CancellationToken)

대화에 자동 관리 메시지를 보냅니다.

(다음에서 상속됨 BotAdapter)
ContinueConversationAsync(String, ConversationReference, BotCallbackHandler, CancellationToken)

봇에서 대화로 자동 관리 메시지를 보냅니다.

CreateConversationAsync(String, String, AppCredentials, ConversationParameters, BotCallbackHandler, CancellationToken)

지정된 채널에서 대화를 만듭니다.

CreateConversationAsync(String, String, AppCredentials, ConversationParameters, BotCallbackHandler, ConversationReference, CancellationToken)
사용되지 않음.

지정된 채널에서 대화를 만듭니다. 오버로드는 테넌트를 포함하여 ConversationReference를 받습니다.

CreateConversationAsync(String, String, MicrosoftAppCredentials, ConversationParameters, BotCallbackHandler, CancellationToken)

지정된 채널에서 대화를 만듭니다.

CreateConversationAsync(String, String, MicrosoftAppCredentials, ConversationParameters, BotCallbackHandler, ConversationReference, CancellationToken)
사용되지 않음.

지정된 채널에서 대화를 만듭니다. 오버로드는 테넌트를 포함하여 ConversationReference를 받습니다.

CreateConversationAsync(String, String, String, String, ConversationParameters, BotCallbackHandler, CancellationToken)

지정된 채널에서 대화를 만듭니다.

(다음에서 상속됨 BotAdapter)
CreateOAuthApiClientAsync(ITurnContext)

봇에 대한 OAuth 클라이언트를 만듭니다.

CreateOAuthApiClientAsync(ITurnContext, AppCredentials)

자격 증명을 사용하여 봇에 대한 OAuth 클라이언트를 만듭니다.

DeleteActivityAsync(ITurnContext, ConversationReference, CancellationToken)

대화에서 기존 활동을 삭제합니다.

DeleteConversationMemberAsync(ITurnContext, String, CancellationToken)

현재 대화에서 멤버를 제거합니다.

ExchangeTokenAsync(ITurnContext, AppCredentials, String, String, TokenExchangeRequest, CancellationToken)

Single Sign-On과 같은 토큰 교환 작업을 수행합니다.

ExchangeTokenAsync(ITurnContext, String, String, TokenExchangeRequest, CancellationToken)

Single Sign-On과 같은 토큰 교환 작업을 수행합니다.

GetAadTokensAsync(ITurnContext, AppCredentials, String, String[], String, CancellationToken)

사용자 지정된 AppCredentials를 사용하여 구성된 연결에서 특정 리소스에 대한 Azure Active Directory 토큰을 검색합니다.

GetAadTokensAsync(ITurnContext, String, String[], String, CancellationToken)

봇의 AppCredentials를 사용하여 구성된 연결에서 특정 리소스에 대한 Azure Active Directory 토큰을 검색합니다.

GetActivityMembersAsync(ITurnContext, String, CancellationToken)

지정된 활동의 멤버를 나열합니다.

GetConversationMembersAsync(ITurnContext, CancellationToken)

현재 대화의 멤버를 나열합니다.

GetConversationsAsync(ITurnContext, String, CancellationToken)

이 봇이 지정된 채널 서버에 참여한 대화를 나열합니다. 채널 서버는 페이지에 결과를 반환하고 각 페이지에는 서버에서 결과의 다음 페이지를 가져오는 데 사용할 수 있는 continuationToken 포함됩니다.

GetConversationsAsync(String, MicrosoftAppCredentials, String, CancellationToken)

이 봇이 지정된 채널 서버에 참여한 대화를 나열합니다. 채널 서버는 페이지에 결과를 반환하고 각 페이지에는 서버에서 결과의 다음 페이지를 가져오는 데 사용할 수 있는 continuationToken 포함됩니다.

GetOauthSignInLinkAsync(ITurnContext, AppCredentials, String, CancellationToken)

사용자 지정된 AppCredentials를 사용하여 연결 이름에 대한 로그인을 위해 사용자에게 보낼 원시 로그인 링크를 가져옵니다.

GetOauthSignInLinkAsync(ITurnContext, AppCredentials, String, String, String, CancellationToken)

사용자 지정된 AppCredentials를 사용하여 연결 이름에 대한 로그인을 위해 사용자에게 보낼 원시 로그인 링크를 가져옵니다.

GetOauthSignInLinkAsync(ITurnContext, String, CancellationToken)

봇의 AppCredentials를 사용하여 연결 이름에 대한 로그인을 위해 사용자에게 보낼 원시 로그인 링크를 가져옵니다.

GetOauthSignInLinkAsync(ITurnContext, String, String, String, CancellationToken)

봇의 AppCredentials를 사용하여 연결 이름에 대한 로그인을 위해 사용자에게 보낼 원시 로그인 링크를 가져옵니다.

GetSignInResourceAsync(ITurnContext, AppCredentials, String, String, String, CancellationToken)

연결 이름에 대한 로그인을 위해 사용자에게 보낼 원시 로그인 링크를 가져옵니다.

GetSignInResourceAsync(ITurnContext, String, CancellationToken)

연결 이름에 대한 로그인을 위해 사용자에게 보낼 원시 로그인 링크를 가져옵니다.

GetSignInResourceAsync(ITurnContext, String, String, String, CancellationToken)

연결 이름에 대한 로그인을 위해 사용자에게 보낼 원시 로그인 링크를 가져옵니다.

GetTokenStatusAsync(ITurnContext, AppCredentials, String, String, CancellationToken)

사용자 지정된 AppCredentials를 사용하여 지정된 사용자에 대해 구성된 각 연결의 토큰 상태를 검색합니다.

GetTokenStatusAsync(ITurnContext, String, String, CancellationToken)

봇의 AppCredentials를 사용하여 지정된 사용자에 대해 구성된 각 연결의 토큰 상태를 검색합니다.

GetUserTokenAsync(ITurnContext, AppCredentials, String, String, CancellationToken)

사용자 지정된 AppCredentials를 사용하여 로그인 흐름에 있는 사용자의 토큰을 검색하려고 시도합니다.

GetUserTokenAsync(ITurnContext, String, String, CancellationToken)

봇의 AppCredentials를 사용하여 로그인 흐름에 있는 사용자의 토큰을 검색하려고 시도합니다.

ProcessActivityAsync(ClaimsIdentity, Activity, BotCallbackHandler, CancellationToken)

턴 컨텍스트를 만들고 들어오는 작업에 대한 미들웨어 파이프라인을 실행합니다.

ProcessActivityAsync(String, Activity, BotCallbackHandler, CancellationToken)

턴 컨텍스트를 만들고 들어오는 작업에 대한 미들웨어 파이프라인을 실행합니다.

ProcessOutgoingActivityAsync(ITurnContext, Activity, CancellationToken)

나가는 활동을 보내는 사용자 지정 논리입니다. 서브클래스는 이 메서드를 CanProcessOutgoingActivity와 함께 재정의하여 나가는 작업을 처리하는 사용자 지정 논리를 가질 수 있습니다.

RunPipelineAsync(ITurnContext, BotCallbackHandler, CancellationToken)

현재 봇 턴에 대한 작업 처리를 시작합니다.

(다음에서 상속됨 BotAdapter)
SendActivitiesAsync(ITurnContext, Activity[], CancellationToken)

대화에 활동을 보냅니다.

SignOutUserAsync(ITurnContext, AppCredentials, String, String, CancellationToken)

사용자 지정된 AppCredentials를 사용하여 토큰 서버로 사용자를 로그아웃합니다.

SignOutUserAsync(ITurnContext, String, String, CancellationToken)

봇의 AppCredentials를 사용하여 토큰 서버로 사용자를 로그아웃합니다.

UpdateActivityAsync(ITurnContext, Activity, CancellationToken)

대화의 기존 활동을 바꿉니다.

Use(IMiddleware)

어댑터의 파이프라인에 미들웨어를 추가합니다.

명시적 인터페이스 구현

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

서비스 엔드포인트에 봇을 연결할 수 있는 봇 어댑터입니다.

확장 메서드

UseBotState(BotAdapter, BotState[])

어댑터에 미들웨어를 추가하여 하나 이상의 BotState 개체를 턴 컨텍스트에 등록합니다. 미들웨어는 각 턴 시작 시 턴 컨텍스트에 상태 개체를 등록합니다.

UseState(BotAdapter, UserState, ConversationState, Boolean)
사용되지 않음.

사용자 및 대화 상태 개체를 어댑터에 등록합니다. 이러한 개체는 턴 컨텍스트의 TurnState통해 사용할 수 있습니다.Get<T>() 메서드입니다.

UseStorage(BotAdapter, IStorage)

어댑터에 미들웨어를 추가하여 턴 컨텍스트에서 IStorage 개체를 등록합니다. 미들웨어는 각 턴 시작 시 턴 컨텍스트에 상태 개체를 등록합니다.

적용 대상

추가 정보