직접 회선 API 3.0의 주요 개념

직접 회선 API를 통해 봇과 고유한 클라이언트 애플리케이션 간에 통신을 사용할 수 있습니다. 이 문서에서는 직접 회선 API 3.0의 주요 개념을 소개하고 관련 개발자 리소스에 대한 정보를 제공합니다. SDK, REST API 또는 웹 채팅을 사용하여 클라이언트를 빌드할 수 있습니다.

인증

Direct Line API 3.0 요청은 Azure Portal Direct Line 채널 구성 페이지에서 가져온 비밀을 사용하거나 런타임에 가져온 토큰을 사용하여 인증할 수 있습니다. 자세한 내용은 인증을 참조하세요.

대화 시작

직접 회선 대화는 클라이언트에서 명시적으로 열고, 봇과 클라이언트가 참여하고 유효한 자격 증명이 있는 경우에만 실행될 수 있습니다. 자세한 내용은 대화 시작을 참조하세요.

메시지 보내기

직접 회선 API 3.0을 사용하면 클라이언트가 HTTP POST 요청을 실행하여 봇에 메시지를 보낼 수 있습니다. 클라이언트는 요청당 하나의 메시지를 보낼 수 있습니다. 자세한 내용은 봇에 작업 보내기를 참조하세요.

메시지 수신

직접 회선 API 3.0을 사용하면 클라이언트가 WebSocket 스트림을 통하거나 HTTP GET 요청을 발행하여 봇으로부터 메시지를 수신할 수 있습니다. 이러한 기술 중 하나를 사용하면 클라이언트는 ActivitySet의 일환으로 봇으로부터 한 번에 여러 메시지를 받을 수 있습니다. 자세한 내용은 봇에서 작업 수신을 참조하세요.

개발자 리소스

클라이언트 라이브러리

Bot Framework는 C# 및 Node.js를 통해 직접 회선 API 3.0에 쉽게 액세스할 수 있는 클라이언트 라이브러리를 제공합니다.

• Visual Studio 프로젝트 내에서 .NET 클라이언트 라이브러리를 사용하려면 NuGet 패키지를 설치 Microsoft.Bot.Connector.DirectLine 합니다.

• Node.js 클라이언트 라이브러리를 사용하려면 NPM을 botframework-directlinejs 사용하여 라이브러리를 설치하거나 원본을 다운로드합니다.

웹 채팅 컨트롤

Bot Framework는 클라이언트 애플리케이션에 직접 회선 기반 봇을 포함할 수 있는 컨트롤을 제공합니다. 자세한 내용은 Microsoft Bot Framework 웹 채팅 컨트롤을 참조하세요.