직접 회선 API 1.1의 주요 개념Key concepts in Direct Line API 1.1

직접 회선 API를 통해 봇과 고유한 클라이언트 애플리케이션 간에 통신을 사용할 수 있습니다.You can enable communication between your bot and your own client application by using the Direct Line API.

중요

이 문서에서는 직접 회선 API 1.1의 주요 개념을 소개하고 관련 개발자 리소스에 대한 정보를 제공합니다.This article introduces key concepts in Direct Line API 1.1 and provides information about relevant developer resources. 클라이언트 애플리케이션과 봇 간에 새 연결을 만들 경우에는 직접 회선 API 3.0을 대신 사용합니다.If you are creating a new connection between your client application and bot, use Direct Line API 3.0 instead.

인증Authentication

Direct Line API 1.1 요청을 인증하려면 Azure Portal의 Direct Line 채널 구성 페이지에서 가져오는 비밀을 사용하거나 런타임에 가져오는 토큰을 사용합니다.Direct Line API 1.1 requests can be authenticated either by using a secret that you obtain from the Direct Line channel configuration page in the Azure Portal or by using a token that you obtain at runtime. 자세한 내용은 인증을 참조하세요.For more information, see Authentication.

대화 시작Starting a conversation

직접 회선 대화는 클라이언트에서 명시적으로 열고, 봇과 클라이언트가 참여하고 유효한 자격 증명이 있는 경우에만 실행될 수 있습니다.Direct Line conversations are explicitly opened by clients and may run as long as the bot and client participate and have valid credentials. 자세한 내용은 대화 시작을 참조하세요.For more information, see Start a conversation.

메시지 보내기Sending messages

직접 회선 API 1.1을 사용하면 클라이언트가 HTTP POST 요청을 실행하여 봇에 메시지를 보낼 수 있습니다.Using Direct Line API 1.1, a client can send messages to your bot by issuing HTTP POST requests. 클라이언트는 요청당 하나의 메시지를 보낼 수 있습니다.A client may send a single message per request. 자세한 내용은 봇에 메시지 보내기를 참조하세요.For more information, see Send a message to the bot.

메시지 수신Receiving messages

직접 회선 API 1.1을 사용하면 클라이언트가 HTTP GET 요청으로 폴링하여 메시지를 받을 수 있습니다.Using Direct Line API 1.1, a client can receive messages by polling with HTTP GET requests. 각 요청에 대한 응답으로 클라이언트는 여러 봇의 메시지를 MessageSet의 일부로 받을 수 있습니다.In response to each request, a client may receive multiple messages from the bot as part of a MessageSet. 자세한 내용은 봇에서 메시지 받기를 참조하세요.For more information, see Receive messages from the bot.

개발자 리소스Developer resources

클라이언트 라이브러리Client library

Bot Framework는 C#을 통해 직접 회선 API 1.1에 쉽게 액세스할 수 있는 클라이언트 라이브러리를 제공합니다.The Bot Framework provides a client library that facilitates access to Direct Line API 1.1 via C#. Visual Studio 프로젝트 내에서 클라이언트 라이브러리를 사용하려면 Microsoft.Bot.Connector.DirectLinev1.x NuGet 패키지를 설치합니다.To use the client library within a Visual Studio project, install the Microsoft.Bot.Connector.DirectLine v1.x NuGet package.

C# 클라이언트 라이브러리를 사용하는 대신, 직접 회선 API 1.1 Swagger 파일을 사용하여 선택한 언어로 고유한 클라이언트 라이브러리를 생성할 수 있습니다.As an alternative to using the C# client library, you can generate your own client library in the language of your choice by using the Direct Line API 1.1 Swagger file.