직접 회선 API 1.1의 주요 개념

직접 회선 API를 통해 봇과 고유한 클라이언트 애플리케이션 간에 통신을 사용할 수 있습니다.

중요

이 문서에서는 직접 회선 API 1.1의 주요 개념을 소개하고 관련 개발자 리소스에 대한 정보를 제공합니다. 클라이언트 애플리케이션과 봇 간에 새 연결을 만드는 경우 Direct Line API 3.0을 대신 사용합니다.

인증

Direct Line API 1.1 요청을 인증하려면 Azure Portal의 Direct Line 채널 구성 페이지에서 가져오는 비밀을 사용하거나 런타임에 가져오는 토큰을 사용합니다. 자세한 내용은 인증을 참조하세요.

대화 시작

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

메시지 보내기

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

메시지 수신

직접 회선 API 1.1을 사용하면 클라이언트가 HTTP GET 요청으로 폴링하여 메시지를 받을 수 있습니다. 각 요청에 대한 응답으로 클라이언트는 여러 봇의 메시지를 MessageSet의 일부로 받을 수 있습니다. 자세한 내용은 봇에서 메시지 받기를 참조하세요.

개발자 리소스

클라이언트 라이브러리

Bot Framework는 C#을 통해 직접 회선 API 1.1에 쉽게 액세스할 수 있는 클라이언트 라이브러리를 제공합니다. Visual Studio 프로젝트 내에서 클라이언트 라이브러리를 사용하려면 v1.x NuGet 패키지를 설치 Microsoft.Bot.Connector.DirectLine 합니다.

C# 클라이언트 라이브러리를 사용하는 대신, 직접 회선 API 1.1 Swagger 파일을 사용하여 선택한 언어로 고유한 클라이언트 라이브러리를 생성할 수 있습니다.