Direct Line API 3.0의 주요 개념
직접 회선 API를 사용하여 봇과 사용자 고유의 클라이언트 애플리케이션 간에 통신을 사용하도록 설정할 수 있습니다. 이 문서에서는 Direct Line API 3.0의 주요 개념을 소개하고 관련 개발자 리소스에 대한 정보를 제공합니다. SDK, REST API 또는 웹 채팅 사용하여 클라이언트를 빌드할 수 있습니다.
인증
직접 회선 API 3.0 요청은 Azure Portal의 Direct Line 채널 구성 페이지에서 가져온 비밀을 사용하거나 런타임에 가져온 토큰을 사용하여 인증할 수 있습니다. 자세한 내용은 인증을 참조하세요.
대화 시작
직접 회선 대화는 클라이언트에서 명시적으로 열고, 봇과 클라이언트가 참여하고 유효한 자격 증명이 있는 경우에만 실행될 수 있습니다. 자세한 내용은 대화 시작을 참조하세요.
메시지 보내기
클라이언트는 직접 회선 API 3.0을 사용하여 요청을 실행하여 HTTP POST
봇에 메시지를 보낼 수 있습니다. 클라이언트는 요청당 단일 메시지를 보낼 수 있습니다. 자세한 내용은 봇에 활동 보내기를 참조 하세요.
메시지 수신
클라이언트는 직접 회선 API 3.0을 사용하여 스트림을 통해 WebSocket
또는 요청을 실행하여 HTTP GET
봇에서 메시지를 받을 수 있습니다. 이러한 기술 중 하나를 사용하면 클라이언트는 ActivitySet
의 일환으로 봇으로부터 한 번에 여러 메시지를 받을 수 있습니다. 자세한 내용은 봇에서 활동 받기를 참조 하세요.
개발자 리소스
클라이언트 라이브러리
Bot Framework는 C# 및 Node.js 통해 Direct Line API 3.0에 쉽게 액세스할 수 있는 클라이언트 라이브러리를 제공합니다.
Visual Studio 프로젝트 내에서 .NET 클라이언트 라이브러리를 사용하려면 NuGet 패키지를 설치
Microsoft.Bot.Connector.DirectLine
합니다.Node.js 클라이언트 라이브러리를 사용하려면 NPM을
botframework-directlinejs
사용하여 라이브러리를 설치하거나 원본을 다운로드합니다.
웹 채팅 컨트롤
Bot Framework는 직접 회선 기반 봇을 클라이언트 애플리케이션에 포함할 수 있는 컨트롤을 제공합니다. 자세한 내용은 Microsoft Bot Framework 웹 채팅 컨트롤을 참조하세요.