> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Azure Logic Apps

> Azure Logic Apps は OpenAPI 仕様を介して Connect AI に接続できます。

## 前提条件

OpenAPI 経由で接続する前に、以下の準備が必要です。

* Connect AI アカウントにデータソースを接続します。詳細については、[ソース](/ja/Sources) を参照してください。
* ワークスペースに[ワークスペースを追加](/ja/Workspaces#add-a-workspace)します。
* ワークスペースに[アセットを追加](/ja/Workspaces#workspace-assets)します。
* [設定](/ja/Settings#personal-access-tokens)ページでパーソナルアクセストークン（PAT）を生成します。認証時のパスワードとして使用するため、コピーして保管してください。
* Azure サブスクリプションでカスタムコネクタを作成するアクセス権があることを確認します。

## Connect AI への接続

OpenAPI を介して Azure Logic Apps から Connect AI への接続を確立するには、以下の手順に従ってください。

<Steps>
  <Step>
    Connect AI の **Workspaces** でワークスペースを選択し、ワークスペースの OpenAPI 仕様をダウンロードします。詳細については、[OpenAPI](/ja/API/OpenAPI) を参照してください。

    <Note>
      OpenAPI バージョン 2.0 を使用し、**Convert array types to strings** を選択する必要があります。
    </Note>

    <Frame>
      <img src="https://mintcdn.com/cdata/DDl5yMaSE1cK608F/ja/images/powerautomate_client_endpoints.png?fit=max&auto=format&n=DDl5yMaSE1cK608F&q=85&s=652615f82301983a4b122d67b16d11d5" alt="" width="750" height="533" data-path="ja/images/powerautomate_client_endpoints.png" />
    </Frame>
  </Step>

  <Step>
    Azure ポータルにログインします。
  </Step>

  <Step>
    Microsoft Azure の **Azure services** で **Create a resource** をクリックします。
  </Step>

  <Step>
    検索バーに *Logic Apps Custom Connector* と入力します。**Create** > **Logic Apps Custom Connector** をクリックします。

    <Frame>
      <img src="https://mintcdn.com/cdata/tJfdD354GT5ojxph/ja/images/logic_apps_client_create_custom.png?fit=max&auto=format&n=tJfdD354GT5ojxph&q=85&s=4e6b7fd81b852d1559a2342a13c9b0c6" alt="" width="279" height="599" data-path="ja/images/logic_apps_client_create_custom.png" />
    </Frame>
  </Step>

  <Step>
    カスタムコネクタの詳細を入力し、**Review + create** をクリックします。

    <Frame>
      <img src="https://mintcdn.com/cdata/tJfdD354GT5ojxph/ja/images/logic_apps_client_create_basics.png?fit=max&auto=format&n=tJfdD354GT5ojxph&q=85&s=4524cdfe5c86b0cdaef600f309a8bf0e" alt="" width="905" height="867" data-path="ja/images/logic_apps_client_create_basics.png" />
    </Frame>

    詳細については、[Microsoft のドキュメント](https://learn.microsoft.com/ja-jp/connectors/custom-connectors/create-logic-apps-connector)を参照してください。
  </Step>

  <Step>
    作成した Logic Apps カスタムコネクタで **Edit** をクリックします。OpenAPI 定義をカスタムコネクタにインポートします。以下の手順に従うか、[Microsoft のドキュメント](https://learn.microsoft.com/ja-jp/connectors/custom-connectors/define-openapi-definition)を参照してください。
  </Step>

  <Step>
    **1. General** で、**Import mode** として **OpenAPI file** を選択します。次に、作成した OpenAPI 定義を指定します。

    <Frame>
      <img src="https://mintcdn.com/cdata/tJfdD354GT5ojxph/ja/images/logic_apps_client_openapi.png?fit=max&auto=format&n=tJfdD354GT5ojxph&q=85&s=baa353090ed61e765ac256d431a2f5bf" alt="" width="1347" height="555" data-path="ja/images/logic_apps_client_openapi.png" />
    </Frame>
  </Step>

  <Step>
    説明を含むコネクタの全般情報を入力します。**Host** と **Base URL** はすでに入力されています。
  </Step>

  <Step>
    **2. Security** ステップで、**Authentication type** として **Basic authentication** を選択します。ユーザーはこの API を使用する前にユーザー名とパスワードを入力する必要があります。ユーザーに表示されるパラメータラベルを入力します。

    <Note>
      カスタムコネクタを使用する際、ユーザー名は Connect AI のユーザー名、パスワードは前提条件で作成した PAT になります。
    </Note>
  </Step>

  <Step>
    コネクタの **3. Definition** ステップでは、OpenAPI 仕様ファイルに含まれるコネクタのすべてのアクションを定義します。アクションには、レコードの一覧表示、取得、作成、更新、削除など、テーブルに必要なすべての機能が含まれます。
    **3. Definition** ステップでは、OpenAPI 仕様からインポートされた **Actions** と **References** を編集できます。

    * **Actions**—カスタムコネクタの各アクションには **General** 情報と、レスポンスの **Request**、**Response**、**Validation** があります。
      たとえば、以下のリクエストはドライブを一覧表示する GET リクエストです。

    <Frame>
      <img src="https://mintcdn.com/cdata/DDl5yMaSE1cK608F/ja/images/powerapps_request.png?fit=max&auto=format&n=DDl5yMaSE1cK608F&q=85&s=b7a2b745051a9babf721b8fdf65402d8" alt="" width="686" height="851" data-path="ja/images/powerapps_request.png" />
    </Frame>

    リクエストには `$top`、`$filter`、`$orderby` などの URL に追加されるクエリパラメータが含まれます。ここでクエリパラメータを編集・削除できます。パラメータは OData プロトコルに基づいています。
    完全なリファレンスについては、[API Operations](/ja/API/OpenAPI#api-operations) を参照してください。
    同様に、新しいレコードを作成する POST リクエストもあります。リクエストにはレコードのすべてのフィールドが含まれており、定義でこれらのフィールドを編集できます。

    * **References**—アクションとトリガーの両方で使用される再利用可能なパラメータです。各リファレンスには **Definition** と **Validation** があります。
  </Step>

  <Step>
    **Update connector** をクリックして変更を保存します。
  </Step>

  <Step>
    カスタムコネクタを使用して Logic Apps を構築できるようになりました。カスタムコネクタを使用した Logic Apps の構築の詳細については、[Microsoft のドキュメント](https://learn.microsoft.com/ja-jp/connectors/custom-connectors/use-custom-connector-logic-apps)を参照してください。
  </Step>
</Steps>