BotAdapter 클래스

정의

서비스 엔드포인트에 봇을 연결할 수 있는 봇 어댑터를 나타냅니다. 이 클래스는 추상 클래스입니다.

public abstract class BotAdapter
type BotAdapter = class
Public MustInherit Class BotAdapter
상속
BotAdapter
파생

설명

봇 어댑터는 인증 프로세스를 캡슐화하고 Bot Connector Service와 작업을 주고받습니다. 봇이 작업을 받으면 어댑터는 컨텍스트 개체를 만들고, 봇의 애플리케이션 논리에 전달하고, 응답을 사용자의 채널로 다시 보냅니다.

를 사용하여 Use(IMiddleware) 어댑터의 미들웨어 컬렉션에 개체를 추가 IMiddleware 합니다. 어댑터는 봇 미들웨어 파이프라인을 통해 들어오는 작업을 처리하고 봇의 논리로 안내한 후 다시 밖으로 내보냅니다. 각 작업이 봇으로 들어가고 나올 때 미들웨어의 각 부분은 봇 논리가 실행되기 전과 후에 작업을 검사하거나 작업에 따라 작동합니다.

생성자

BotAdapter()

BotAdapter 클래스의 새 인스턴스를 초기화합니다.

필드

BotIdentityKey

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

InvokeResponseKey

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

OAuthScopeKey

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

속성

MiddlewareSet

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

OnTurnError

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

메서드

ContinueConversationAsync(ClaimsIdentity, Activity, BotCallbackHandler, CancellationToken)

대화에 사전 대응 메시지를 보냅니다.

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

대화에 사전 대응 메시지를 보냅니다.

ContinueConversationAsync(ClaimsIdentity, ConversationReference, BotCallbackHandler, CancellationToken)

대화에 사전 대응 메시지를 보냅니다.

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

대화에 사전 대응 메시지를 보냅니다.

ContinueConversationAsync(String, Activity, BotCallbackHandler, CancellationToken)

대화에 사전 대응 메시지를 보냅니다.

ContinueConversationAsync(String, ConversationReference, BotCallbackHandler, CancellationToken)

대화에 사전 대응 메시지를 보냅니다.

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

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

DeleteActivityAsync(ITurnContext, ConversationReference, CancellationToken)

파생 클래스에서 재정의된 경우 대화에서 기존 활동을 삭제합니다.

ProcessActivityAsync(ClaimsIdentity, Activity, BotCallbackHandler, CancellationToken)

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

RunPipelineAsync(ITurnContext, BotCallbackHandler, CancellationToken)

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

SendActivitiesAsync(ITurnContext, Activity[], CancellationToken)

파생 클래스에서 재정의된 경우 는 대화에 활동을 보냅니다.

UpdateActivityAsync(ITurnContext, Activity, CancellationToken)

파생 클래스에서 재정의되는 경우 는 대화의 기존 활동을 대체합니다.

Use(IMiddleware)

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

확장 메서드

UseBotState(BotAdapter, BotState[])

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

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

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

UseStorage(BotAdapter, IStorage)

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

적용 대상

추가 정보