에이전트를 Azure Bot Service 채널에 게시

아티클
12/09/2024

기존 Azure Bot Service 채널 에 연결할 수 있습니다. 이는 Azure Bot Service 채널의 최종 사용자에게 에이전트를 연결하려는 경우 유용합니다.

에이전트를 Azure Bot Service 채널에 추가하려면 상당한 개발자 전문 지식이 필요합니다. 이 문서는 코드 개발 및 작성 경험이 있는 IT 관리자 또는 개발자를 위해 작성되었습니다.

팁

이 문서를 따라와하지 않아도 Copilot Studio 에이전트을(를) 귀하의 웹사이트 Facebook에 추가할 수 있습니다 Microsoft Teams. 목표가 연결를 맞춤형 웹 기반 앱이나 네이티브 앱으로 전환하는 것이라면, 개발자는 에이전트를 모바일 또는 맞춤형 앱에 게시에서 자세한 내용을 알아볼 수 있습니다.

중요

이 섹션의 지침에는 사용자 또는 개발자의 소프트웨어 개발이 필요합니다. 개발자 도구, 유틸리티 및 IDE에 대해 잘 알고 있는 IT 관리자나 개발자와 같은 숙련된 IT 전문가를 대상으로 합니다.

필수 구성 요소

Azure Bot Service 구독.
v4 SDK를 사용하는 Azure Bot Service 봇.
.NET Core SDK 버전 2.1.
NuGet 패키지 Microsoft.Bot.Connector.DirectLine.
에이전트가 Azure Bot Service 채널로 연결하려는 Copilot Studio 채널에서 생성되었습니다.
모바일이나 사용자 정의 앱에 에이전트를 게시하세요.

샘플 코드

이 문서에 사용된 코드 조각은 릴레이 봇 샘플 코드의 것입니다.

참조

이 문서의 지침은 다음 문서를 참조합니다.

Azure Bot Service 봇 배포에 대한 지침을 위한 Azure에 봇 배포.
Azure Bot Service 지원 채널에 연결하기 위한 Azure Bot Service 채널.
Azure Bot Service 봇 디버깅에 대한 지침을 위한 에뮬레이터를 사용한 Azure Bot Service 디버그.

기존 Azure Bot Service 봇 만들기 또는 사용

Copilot Studio 에이전트와 Azure Bot Service 채널 간에 대화를 전달할 수 있는 Azure Bot Service 봇가 필요합니다.

릴레이 봇 다이어그램.

릴레이 봇 샘플 코드는 기존 Azure Bot Service 봇이 없는 경우 좋은 출발점입니다. 그것은 Microsoft Bot Framework 봇 샘플 코드에서 빌드되며 컴파일하여 Azure Bot Service에 배포할 수 있습니다. 샘플 코드는 시작점으로 사용하기 위한 것이며 프로덕션 환경에서 직접 사용할 수 없습니다. 비즈니스 요구에 맞게 코드와 최적화를 추가해야 합니다.

Azure Bot Service 봇이 이미 있는 경우 대화 세션을 관리하기 위해 Copilot Studio 커넥터 및 코드를 추가해야 합니다. 그런 다음 봇을 Azure Bot Service에 배포하고 Azure Portal을 사용하여 채널에 연결할 수 있습니다.

Copilot Studio 에이전트 매개변수를 받으세요

여러분이 만든 에이전트에 연결를 적용하려면 Copilot Studio 여러분의 에이전트의 이름과 토큰 끝점를 가져와야 합니다.

에이전트의 이름을 Copilot Studio에 복사하세요.
탐색 메뉴에서 설정 아래의 채널을 선택합니다.
연결하려는 채널을 선택하십시오. 이 시나리오는 Slack을 예로 사용합니다.
토큰 끝점 값을 복사하고 저장하려면 복사를 선택합니다. 에이전트를 Azure Bot Service 채널로 끝점에서 연결로 전송해야 합니다.

Copilot Studio 에이전트로 대화 세션을 관리하세요

Azure Bot Service 채널과 에이전트와의 연결 Direct Line 간에 여러 대화가 있을 수 있습니다. Copilot Studio

귀하의 Azure Bot Service 봇는 Azure Bot Service 채널의 대화를 매핑하고 전달해야 합니다. Direct Line 에이전트와의 대화 Copilot Studio 그리고 그 반대의 경우도 마찬가지입니다.

샘플 코드 예

다음 예는 릴레이 봇 샘플 코드의 샘플을 사용합니다.

모든 새로운 외부 Azure Bot Service 채널 대화가 시작될 때마다 Copilot Studio 에이전트 대화를 시작하세요. 봇와 새로운 대화를 시작하는 방법에 대한 지침은 Get Direct Line token and Use Direct Line 를 참조하여 에이전트와 통신하세요.

using (var httpRequest = new HttpRequestMessage())
{   
    httpRequest.Method = HttpMethod.Get;
    UriBuilder uriBuilder = new UriBuilder(TokenEndPoint);
    httpRequest.RequestUri = uriBuilder.Uri;
    using (var response = await s_httpClient.SendAsync(httpRequest))
    {
        var responseString = await response.Content.ReadAsStringAsync();
        string token = SafeJsonConvert.DeserializeObject<DirectLineToken>(responseString).Token;
    }
}

/// <summary>
/// class for serialization/deserialization DirectLineToken
/// </summary>
public class DirectLineToken
{
    public string Token { get; set; }
}

 // Use the retrieved token to create a DirectLineClient instance
 using (var directLineClient = new DirectLineClient(token))
 {
     var conversation = await directLineClient.Conversations.StartConversationAsync();
     string conversationtId = conversation.ConversationId;
 }

여러 세션을 관리하려면 외부 Azure Bot Service 채널 대화와 해당 Copilot Studio 에이전트 대화의 매핑를 유지해야 합니다. Copilot Studio 에이전트 대화는 두 가지 속성인 ConversationtId 및 Token을 통해 식별되고 연결될 수 있습니다.

Dictionary<string, PowerVirtualAgentsConversation> ConversationRouter = new Dictionary<string, PowerVirtualAgentsConversation>();

대화 수명 주기를 관리하려면 Direct Line 토큰을 새로 고치거나 유휴 대화를 정리하세요. Direct Line 토큰 새로 고침에서 토큰 새로 고침에 대해 자세히 알아보세요. Copilot Studio 에이전트 토큰 새로 고침을 지원하는 대화는 다음과 같이 정의됩니다. Direct Line

/// <summary>
/// Data model class for Copilot Studio agent conversation
/// </summary>
public class PowerVirtualAgentsConversation
{
    public string ConversationtId { get; set; } // The Copilot Studio agent conversation ID retrieved from step 1

    public string Token { get; set; } // The DirectLine token retrieved from step 1

    public string WaterMark { get; set; } // Identify turn in a conversation

    public DateTime LastTokenRefreshTime { get; set; } = DateTime.Now; // Timestamp of last token refresh

    public DateTime LastConversationUpdateTime { get; set; } = DateTime.Now; // Timestamp of last active user message sent to agent
}

새로운 Copilot Studio 에이전트 대화가 시작되면 매핑 테이블에 키 값 쌍(external_Azure_Bot_Service_channel_conversationID, PowerVirtualAgentsConversation)을 추가합니다.

// After new Copilot Studio agent conversation starts
ConversationRouter[external_Azure_Bot_Service_channel_conversationID] = new PowerVirtualAgentsConversation()
  {
    Token = token,
    ConversationtId = conversationId,
    WaterMark = null,
    LastConversationUpdateTime = DateTime.Now,
    LastTokenRefreshTime = DateTime.Now,
  };

기존 대화를 계속하려면 새로운 외부 Azure Bot Service 채널 메시지를 받으면 매핑 테이블에서 기존 대화를 검색하고 외부 대화 활동을 Copilot Studio 에이전트로 전달하고 응답를 받습니다.

다음 샘플은 ActivityHandler.OnMessageActivityAsync((ITurnContext<IMessageActivity>, CancellationToken) 메서드를 재정의함으로써 대화 릴레이를 보여줍니다.

// Invoked when a message activity is received from the user
// Send the user message to Copilot Studio agent and get response
protected override async Task OnMessageActivityAsync(ITurnContext<IMessageActivity> turnContext, CancellationToken cancellationToken)
{
    // Retrieve agent conversation from mapping table
    // If not exists for the given external conversation ID, start a new Copilot Studio agent conversation
    ConversationRouter.TryGetValue(externalCID, out PowerVirtualAgentsConversation currentConversation) ?
            currentConversation : /*await StartBotConversationAsync(externalCID)*/;

    // Create DirectLine client with the token associated to current conversation
    DirectLineClient client = new DirectLineClient(currentConversation.Token);

    // Send user message using directlineClient
    await client.Conversations.PostActivityAsync(currentConversation.ConversationtId, new DirectLineActivity()
    {
      Type = DirectLineActivityTypes.Message,
      From = new ChannelAccount { Id = turnContext.Activity.From.Id, Name = turnContext.Activity.From.Name },
      Text = turnContext.Activity.Text,
      TextFormat = turnContext.Activity.TextFormat,
      Locale = turnContext.Activity.Locale,
    });

    // Update LastConversationUpdateTime for session management
    currentConversation.LastConversationUpdateTime = DateTime.Now;
}

에이전트와 통신하려면 사용 Direct Line 을 참조하세요. 에이전트's 응답.를 얻는 방법 Copilot Studio Copilot Studio 에이전트's 응답가 수신되면 에이전트에서 대화 페이로드 구문 분석 을 참조하여 외부 Azure Bot Service 채널 응답로 응답를 구문 분석하는 방법을 알아보세요.

응답 구문 분석의 예는 릴레이 봇 샘플 코드 ResponseConverter.cs에서 찾을 수 있습니다.

Azure Bot Service에 배포

Azure Bot Service 릴레이 봇이 준비되었으면 봇을 Azure Bot Service에 배포해야 합니다.

Azure Bot Service 채널 설정

Azure Portal에 로그인하고 배포한 Azure Bot Service 리소스 그룹을 선택하여 연결하려는 채널을 설정할 수 있습니다. Azure Bot Service 채널에서 각 채널에 대한 특정 지침을 봅니다.

다음을 통해 공유