다음을 통해 공유


Bot Connector API의 주요 개념

Bot Framework 및 Azure AI Bot Service를 사용하면 봇이 Teams, Facebook 등에서 사용자와 통신할 수 있습니다. 채널은 다음 두 가지 형식으로 제공됩니다.

  • Azure AI Bot Service의 일부로 포함된 서비스입니다.
  • Bot Framework SDK와 함께 사용할 어댑터 라이브러리입니다.

이 문서에서는 Azure AI Bot Service에 포함된 표준 채널에 중점을 둡니다.

Bot Framework 채널

Bot Framework 채널을 사용하면 봇이 Azure Portal에서 구성된 채널과 메시지를 교환할 수 있습니다. HTTPS를 통해 업계 표준 REST 및 JSON을 사용하며 JWT 전달자 토큰을 사용하여 인증할 수 있습니다. Bot Connector 서비스를 사용하는 방법에 대한 자세한 내용은 인증 및 이 섹션의 나머지 문서를 참조하세요.

활동

커넥터 서비스는 활동 개체를 전달하여 봇과 채널(사용자) 간에 정보를 교환합니다. 가장 일반적인 활동 유형은 메시지이지만 다양한 유형의 정보를 봇 또는 채널에 전달하는 데 사용할 수 있는 다른 활동 유형이 있습니다. Bot Connector 서비스의 활동에 대한 자세한 내용은 활동 개요를 참조하세요.

인증

Bot Framework 서비스는 인증에 JWT 전달자 토큰을 사용합니다. 봇이 Bot Framework에 보내는 아웃바운드 요청을 인증하는 방법 및 봇이 Bot Framework에서 수신하는 인바운드 요청을 인증하는 방법에 대한 자세한 내용은 인증을 참조하세요.

클라이언트 라이브러리

Bot Framework는 C#, JavaScript, Python 및 Java에서 봇을 빌드하는 데 사용할 수 있는 클라이언트 라이브러리를 제공합니다.

  • C#용 Bot Framework SDK.
  • Node.js 위한 Bot Framework SDK.
  • Python용 Bot Framework SDK.
  • Java용 Bot Framework SDK.

참고 항목

선택한 AI 서비스, 오케스트레이션 및 지식으로 에이전트를 빌드하려면 Microsoft 365 에이전트 SDK를 사용하는 것이 좋습니다. 에이전트 SDK는 C#, JavaScript 또는 Python을 지원합니다. aka.ms/agents 에이전트 SDK에 대해 자세히 알아볼 수 있습니다. SaaS 기반 에이전트 플랫폼을 찾고 있는 경우 Microsoft Copilot Studio를 고려하세요. Bot Framework SDK를 사용하여 빌드된 기존 봇이 있는 경우 봇을 에이전트 SDK로 업데이트할 수 있습니다. Bot Framework SDK에서 에이전트 SDK로의 주요 변경 내용 및 업데이트를 검토할 수 있습니다. Bot Framework SDK에 대한 지원 티켓은 2025년 12월 31일부터 더 이상 서비스되지 않습니다.

Bot Framework REST API 호출을 간소화하는 것 외에도 각 Bot Framework SDK는 대화 논리를 캡슐화하는 대화 상자를 빌드하는 지원, 예/아니요, 문자열, 숫자 및 열거형과 같은 간단한 항목에 대한 기본 제공 프롬프트, LUIS와 같은 강력한 AI 프레임워크에 대한 기본 제공 지원 등을 제공합니다.

참고 항목

Azure AI QnA Maker는 2025년 3월 31일에 사용 중지됩니다. 2022년 10월 1일부터 새로운 QnA Maker 리소스 또는 참조 자료를 만들 수 없습니다. 이제 최신 버전의 질문 및 답변 기능이 Azure AI 언어의 일부로 사용할 수 있습니다.

Azure AI Language의 기능인 사용자 지정 질문 답변은 QnA Maker 서비스의 업데이트된 버전입니다. Bot Framework SDK의 질문 및 답변 지원에 대한 자세한 내용은 자연어 이해를 참조하세요.

참고 항목

LUIS(Language Understanding)는 2025년 10월 1일에 사용 중지됩니다. 2023년 4월 1일부터 새 LUIS 리소스를 만들 수 없습니다. 이제 최신 버전의 언어 이해가 Azure AI Language의 일부로 제공됩니다.

Azure AI Language의 기능인 CLU(대화형 언어 이해)는 업데이트된 LUIS 버전입니다. Bot Framework SDK의 언어 이해 지원에 대한 자세한 내용은 자연어 이해를 참조하세요.

참고 항목

이러한 SDK를 사용하는 대신 Bot Connector Swagger 파일 또는 코드를 REST API로 직접 사용하여 원하는 언어로 고유한 클라이언트 라이브러리를 생성할 수 있습니다.

Bot State 서비스

Microsoft Bot Framework State 서비스는 2018년 3월 30일부터 사용 중지됩니다. 이전에는 Azure AI Bot Service 또는 Bot Builder SDK를 기반으로 빌드된 봇이 봇 상태 데이터를 저장하기 위해 Microsoft에서 호스트하는 이 서비스에 대한 기본 연결이 있었습니다. 자체 상태 스토리지를 사용하려면 봇을 업데이트해야 합니다.

추가 정보

인증부터 시작하여 이 섹션 전체의 문서를 검토하여 커넥터 서비스를 사용하여 봇을 빌드하는 방법에 대해 자세히 알아봅니다. 문제가 발생하거나 커넥터 서비스에 대한 제안이 있는 경우 사용 가능한 리소스 목록에 대한 지원을 참조하세요.