처음부터 사용자 지정 커넥터 만들기Create a custom connector from scratch

참고

이 항목은 Azure Logic Apps, Power Automate 및 Power Apps에서 사용자 지정 커넥터를 만들고 사용하는 방법에 대한 자습서 시리즈의 일부입니다.This topic is part of a tutorial series on creating and using custom connectors in Azure Logic Apps, Power Automate, and Power Apps. 프로세스를 이해하려면 사용자 지정 커넥터 개요를 읽으십시오.Make sure you read the custom connector overview to understand the process.

사용자 지정 커넥터를 만들려면 커넥터에서 API의 작업 및 데이터 구조를 인식할 수 있도록 연결하려는 API를 설명해야 합니다.To create a custom connector, you must describe the API you want to connect to so that the connector understands the API's operations and data structures. 이 항목에서는 Postman 컬렉션 또는 OpenAPI 정의를 사용하지 않고 Cognitive Services Text Analytics 감정 API(이 시리즈의 예)를 설명하지 않고 처음부터 사용자 지정 커넥터를 만듭니다.In this topic, you create a custom connector from scratch, without using a Postman collection or an OpenAPI definition to describe the Cognitive Services Text Analytics Sentiment API (our example for this series). 대신 사용자 지정 커넥터 마법사에서 커넥터를 자세히 설명합니다.Instead, you describe the connector completely in the custom connector wizard.

API를 설명하는 다른 방법은 다음 주제를 참조하십시오.For other ways to describe an API, see the following topics:

참고

현재 Power Automate 및 Power Apps에서 처음부터 사용자 지정 커넥터를 만들 수 있습니다.You can currently create a custom connector from scratch in Power Automate and Power Apps. Logic Apps의 경우 최소한 기본 OpenAPI 정의 또는 Postman 컬렉션으로 시작해야 합니다.For Logic Apps, you must start with at least a basic OpenAPI definition or Postman collection.

필수 구성 요소Prerequisites

사용자 지정 커넥터 마법사를 시작합니다.Start the custom connector wizard

  1. powerapps.com 또는 flow.microsoft.com으로 이동합니다.Go to powerapps.com or flow.microsoft.com.

  2. 탐색 창에서데이터 > 사용자 지정 커넥터를 차례로 선택합니다.In the navigation pane, select Data > Custom connectors.

    사용자 지정 커넥터 선택Select custom connector

  3. 새 사용자 지정 커넥터, 빈 페이지에서 만들기를 차례로 선택합니다.Select New custom connector, then choose Create from blank.

    빈 페이지에서 만들기Create from blank

  4. 사용자 지정 커넥터의 이름을 입력한 다음, 계속을 선택합니다.Enter a name for the custom connector, then select Continue.

    사용자 지정 커넥터 이름 입력

    매개 변수Parameter Value
    사용자 지정 커넥터 제목Custom connector title "SentimentDemo""SentimentDemo"

일반 세부 정보 업데이트Update general details

이 시점에서 Power Automate UI가 표시되지만, 단계는 기술 전체에서 거의 동일합니다.From this point, we'll show the Power Automate UI, but the steps are largely the same across the technologies. 차이점을 지적하겠습니다.We'll point out any differences.

  1. 일반 페이지에서:On the General page:

    • 설명에 대한 의미 있는 값을 입력합니다.Enter a meaningful value for Description. 이 설명은 사용자 지정 커넥터의 세부 정보에 표시되며, 다른 사람들이 커넥터를 유용하게 사용할 수 있는지 파악하는 데 도움이 됩니다.This description is displayed in the custom connector's details, and it can help others know if the connector could be useful to them.

    • 호스트를 텍스트 분석 API의 주소로 업데이트합니다.Update Host to the address for the Text Analytics API. 커넥터는 API 호스트와 기준 URL을 사용하여 API를 호출하는 방법을 결정합니다.The connector uses the API host and the base URL to determine how to call the API.

    사용자 지정 커넥터 일반 페이지

    매개 변수Parameter Value
    설명Description "Cognitive Services 텍스트 분석 감정 API를 사용하여 텍스트가 양수 또는 음수인지 확인합니다.""Uses the Cognitive Services Text Analytics Sentiment API to determine whether text is positive or negative"
    호스트Host "westus.api.cognitive.microsoft.com""westus.api.cognitive.microsoft.com"

    참고

    온-프레미스 데이터 게이트웨이를 통한 연결 옵션에 대한 자세한 내용은 데이터 게이트웨이를 사용하여 온-프레미스 API에 연결을 참조하십시오.For more information about the option Connect via on-premises data gateway, see Connect to on-premises APIs using the data gateway.

인증 유형 지정Specify authentication type

사용자 지정 커넥터의 인증에는 여러 가지 옵션을 사용할 수 있습니다.There are several options available for authentication in custom connectors. Cognitive Services API는 이 자습서에서 지정하는 대로 API 키 인증을 사용합니다.The Cognitive Services APIs use API key authentication, so that's what you specify for this tutorial.

  1. 보안 페이지의 인증 유형 아래에서 API 키를 선택합니다.On the Security page, under Authentication type, choose API Key.

    인증 유형

  2. API 키 아래에서 매개 변수 레이블, 이름 및 위치를 지정합니다.Under API Key, specify a parameter label, name, and location. 누군가가 사용자 지정 커넥터와 처음 연결할 때 표시되므로 의미 있는 레이블을 지정합니다.Specify a meaningful label, because this is displayed when someone first makes a connection with the custom connector. 매개 변수 이름 및 위치는 API가 예상하는 것과 일치해야 합니다.The parameter name and location must match what the API expects. 연결을 선택합니다.Choose Connect.

    API 키 매개 변수

    매개 변수Parameter Value
    매개 변수 레이블Parameter label "API 키""API key"
    매개 변수 이름Parameter name "Ocp-Apim-Subscription-Key""Ocp-Apim-Subscription-Key"
    매개 변수 위치Parameter location "헤더""Header"
  3. 마법사 위쪽에서 이름이 "SentimentDemo"로 설정되어 있는지 확인한 다음, 커넥터 만들기를 선택합니다.At the top of the wizard, make sure the name is set to "SentimentDemo", then choose Create connector.

커넥터 정의 만들기Create the connector definition

사용자 지정 커넥터 마법사는 커넥터가 작동하는 방법과 논리 앱, 흐름 및 앱에서 노출되는 방법을 정의하는 많은 옵션을 제공합니다.The custom connector wizard gives you a lot of options for defining how your connector functions, and how it is exposed in logic apps, flows, and apps. UI에 대해 설명하고 이 섹션의 몇 가지 옵션을 다루지만 직접 탐색해 보는 것도 좋습니다.We'll explain the UI and cover a few options in this section, but we also encourage you to explore on your own.

작업 만들기Create an action

가장 먼저 할 일은 Text Analytics 감정 API를 호출하는 작업을 만드는 것입니다.The first thing to do is create an action that calls the Text Analytics Sentiment API.

  1. 정의 페이지의 왼쪽 영역에는 커넥터에 대해 정의된 모든 작업, 트리거(Logic Apps 및 Power Automate용) 및 참조가 표시됩니다.On the Definition page, the left area displays any actions, triggers (for Logic Apps and Power Automate), and references that are defined for the connector. 새 작업을 선택합니다.Choose New action.

    정의 페이지 - 작업 및 트리거

    이 커넥터에는 트리거가 없지만, Azure Logic Apps 및 Power Automate에서 웹후크 사용에서 사용자 지정 커넥터에 대한 트리거를 알아볼 수 있습니다.There are no triggers in this connector, but you can learn about triggers for custom connectors in Use webhooks with Azure Logic Apps and Power Automate.

  2. 일반 영역에는 현재 선택된 작업 또는 트리거에 대한 정보가 표시됩니다.The General area displays information about the action or trigger currently selected. 이 작업에 대한 요약, 설명 및 작업 ID를 추가합니다.Add a summary, description, and operation ID for this action.

    정의 페이지 - 일반

    매개 변수Parameter Value
    Summary(요약)Summary "감지된 감정을 나타내는 숫자 점수 반환""Returns a numeric score representing the sentiment detected"
    설명Description "이 API는 0~1 사이의 숫자 점수를 반환합니다."The API returns a numeric score between 0 and 1. 1에 가까운 점수는 긍정적인 정서를 나타내고, 0에 가까운 점수는 부정적인 정서를 나타냅니다."Scores close to 1 indicate positive sentiment, while scores close to 0 indicate negative sentiment."
    작업 IDOperation ID "DetectSentiment""DetectSentiment"

    표시 속성을 없음 설정으로 둡니다.Leave the Visibility property set to none. 논리 앱 또는 흐름의 작업 및 매개 변수의 이 속성에는 다음과 같은 옵션이 있습니다.This property for operations and parameters in a logic app or flow has the following options:

    • 없음: 일반적으로 논리 앱 또는 흐름에 표시됩니다.none: displayed normally in the logic app or flow
    • 고급: 추가 메뉴 아래에 숨겨져 있습니다.advanced: hidden under an additional menu
    • 내부: 사용자에게 표시되지 않습니다.internal: hidden from the user
    • 중요: 사용자에게 항상 먼저 표시됩니다.important: always shown to the user first
  3. 요청 영역에는 작업에 대한 HTTP 요청을 기반으로 정보가 표시됩니다.The Request area displays information based on the HTTP request for the action. 샘플에서 가져오기를 선택합니다.Choose Import from sample.

    정의 페이지 - 샘플에서 가져오기

  4. API 및 요청 본문에 연결하는 데 필요한 정보를 지정한 다음 가져오기를 선택합니다.Specify the information necessary to connect to the API, and the request body, then choose Import. 이미지 아래에 이 정보를 제공합니다.We provide this information for you (below the image). 공개 API의 경우 일반적으로 Text Analytics 감정 API 같은 문서에서 가져옵니다.For a public API, you typically get it from the documentation, like Text Analytics Sentiment API.

    정의 페이지 - 샘플에서 가져오기

    매개 변수Parameter Value
    동사Verb "POST""POST"
    URLURL "https://westus.api.cognitive.microsoft.com/text/analytics/v2.0/sentiment""https://westus.api.cognitive.microsoft.com/text/analytics/v2.0/sentiment"
    본문Body 아래 참조See below
    {
      "documents": [
        {
          "language": "string",
          "id": "string",
          "text": "string"
        }
      ]
    }
    
  5. 응답 영역에는 작업에 대한 HTTP 응답을 기반으로 정보가 표시됩니다.The Response area displays information based on the HTTP response for the action. 기본 응답 추가를 선택합니다.Choose Add default response.

    정의 페이지 - 응답

  6. 응답 본문을 지정한 다음 가져오기를 선택합니다.Specify the response body, then choose Import. 요청과 마찬가지로 이 정보를 제공하지만 일반적으로 API 설명서에 있습니다.Like the request, we provide this information for you, but it's typically in the API documentation.

    정의 페이지 - 응답

    {
     "documents": [
       {
         "score": 0.0,
         "id": "string"
       }
     ],
     "errors": [
       {
         "id": "string",
         "message": "string"
       }
     ]
    }
    
  7. 유효성 검사 영역에는 API 정의에서 검색된 모든 문제가 표시됩니다.The Validation area displays any issues that are detected in the API definition. 상태를 확인한 다음 마법사의 오른쪽 상단에서 업데이트 커넥터를 선택합니다.Check the status, then at the top right of the wizard, choose Update connector.

    정의 페이지 - 유효성 검사

정의 업데이트Update the definition

이제 누군가가 논리 앱, 흐름 또는 앱에서 커넥터를 사용하는 경우 커넥터를 더 쉽게 사용할 수 있도록 몇 가지 항목을 변경해 보겠습니다.Now let's change a few things so that the connector is more friendly when someones uses it in a logic app, flow, or app.

  1. 요청 영역에서 본문을 선택한 다음, 편집을 선택합니다.In the Request area, choose body then Edit.

    요청 본문 편집

  2. 매개 변수 영역에서 API에 필요한 세 가지 매개 변수인 id, languagetext가 표시됩니다.In the Parameter area, you now see the three parameters that the API expects: id, language, and text. id, 편집을 차례로 선택합니다.Choose id then Edit.

    요청 본문 id 편집

  3. 스키마 속성 영역에서 매개 변수에 대한 값을 업데이트한 다음, 뒤로를 선택합니다.In the Schema Property area, update values for the parameter, then choose Back.

    스키마 속성 편집

    매개 변수Parameter Value
    제목Title "ID""ID"
    설명Description "제출하는 각 문서에 대한 식별자입니다.""An identifier for each document that you submit"
    기본값Default value "1""1"
    필요함Is required "예""Yes"
  4. 매개 변수 영역에서 언어, 편집을 차례로 선택하고, 다음 값을 사용하여 id에서 사용한 프로세스를 반복합니다.In the Parameter area, choose language then Edit, and repeat the process you used for id, with the following values.

    매개 변수Parameter Value
    제목Title "언어""Language"
    설명Description "텍스트에 대한 2 또는 4자 언어 코드입니다.""The 2 or 4 character language code for the text"
    기본값Default value "en""en"
    필요함Is required "예""Yes"
  5. 매개 변수 영역에서 텍스트, 편집을 차례로 선택하고, 다음 값을 사용하여 idlanguage에서 사용한 프로세스를 반복합니다.In the Parameter area, choose text then Edit, and repeat the process you used for id and language, with the following values.

    매개 변수Parameter Value
    제목Title "텍스트""Text"
    설명Description "감정에서 분석할 텍스트입니다.""The text to analyze for sentiment"
    기본값Default value 없음None
    필요함Is required "예""Yes"
  6. 매개 변수 영역에서 뒤로를 선택하여 기본 정의 페이지로 돌아갑니다.In the Parameter area, choose Back to take you back to the main definition page.

  7. 마법사의 오른쪽 위에서 커넥터 업데이트를 선택합니다.At the top right of the wizard, choose Update connector.

커넥터 테스트Test the connector

이제 커넥터를 만들었으므로 이를 테스트하여 제대로 작동하는지 확인합니다.Now that you've created the connector, test it to make sure it's working properly. 테스트는 현재 Power Automate 및 Power Apps에서만 사용할 수 있습니다.Testing is currently available only in Power Automate and Power Apps.

중요

API 키를 사용할 때는 커넥터를 만든 직후에 커넥터를 테스트하지 않는 것이 좋습니다.When using an API key, we recommend not testing the connector immediately after you create it. 커넥터가 API에 연결할 준비가 될 때까지 몇 분이 걸릴 수 있습니다.It can take a few minutes until the connector is ready to connect to the API.

  1. 테스트 페이지에서 새 연결을 선택합니다.On the Test page, choose New connection.

    새 연결

  2. Text Analytics API에서 API 키를 입력한 다음, 연결 만들기를 선택합니다.Enter the API key from the Text Analytics API, then choose Create connection.

    연결 만들기

  3. 테스트 페이지로 돌아갑니다.Return to the Test page:

    • Power Automate의 경우 테스트 페이지로 다시 이동합니다.In Power Automate, you are taken back to the Test page. 새로 고침 아이콘을 선택하여 연결 정보가 업데이트되었는지 확인합니다.Choose the refresh icon to make sure the connection information is updated.

      연결 새로 고침

    • Power Apps의 경우 현재 환경에서 사용할 수 있는 연결 목록으로 이동합니다.In Power Apps, you are taken to the list of connections available in the current environment. 탐색 창에서데이터 > 사용자 지정 커넥터를 차례로 선택합니다.In the navigation pane, choose Data > Custom connectors. 만든 커넥터를 선택한 다음, 테스트 페이지로 돌아갑니다.Choose the connector you created, then go back to the Test page.

      사용자 지정 커넥터 선택Select custom connector

  4. 테스트 페이지에서 텍스트 필드에 대한 값을 입력하고(다른 필드는 이전에 설정한 기본값을 사용함) 테스트 작업을 선택합니다.On the Test page, enter a value for the text field (the other fields use the defaults that you set earlier), then choose Test operation.

    테스트 작업

  5. 커넥터는 API를 호출하고 감정 점수가 포함된 응답을 검토할 수 있습니다.The connector calls the API, and you can review the response, which includes the sentiment score.

    커넥터 응답

다음 단계Next steps

이제 사용자 지정 커넥터를 만들고 해당 동작을 정의했으므로 커넥터를 사용할 수 있습니다.Now that you've created a custom connector and defined its behaviors, you can use the connector:

조직 외부의 사용자가 사용할 수 있도록 조직 내에서 커넥터를 공유하거나 커넥터 인증을 받을 수도 있습니다.You can also share a connector within your organization and/or get the connector certified so that people outside your organization can use it: