---
title: エージェントアプリを接続して制御する
description: エージェントアプリを見つけて、許可するツールを選択し、接続して、アクセスを管理します。
---

エージェントアプリを使用すると、Runner エージェントはプロジェクトで作業中に外部サービスを使用できます。
アプリのツールを検査して、エージェントに使用させたくないツールをオフにすることができます。

## 開始する前に

**エントリパス:** **プロジェクト → アプリ → エージェントアプリ**

エージェントアプリは条件付きです。セクションが非表示になったり、個別のアプリが
利用できなくなったり、カタログの読み込みに失敗したりする可能性があります。可用性はワークスペース、プロジェクト、
プロバイダー、およびステージング製品アクセスによって異なる場合があります。

必要なもの:

- プロジェクトへのアクセス;
- 選択したプロバイダーが受け入れるアカウントまたは認証情報; および
- 有効にしたままのツールを Runner に使用させる権限。

接続する前にすべてのツールを確認してください。ツールアクセスは現在のプロジェクトに適用され、
エージェントが外部サービスのデータを読み取ったり変更したりすることを許可できます。

外部アカウント接続はサインインした Runner アカウントに属し、ツールスイッチは現在のプロジェクトに保存されます。
したがって、切断すると、ツール選択は別であっても、他のプロジェクトで使用されている接続が削除される可能性があります。

## アプリを見つけて検査する

| コントロールまたは状態 | 有用な理由 | 次に何が起こるか |
| --- | --- | --- |
| **アプリを検索** | ストアアプリとエージェントアプリをフィルタリングします。 | カタログは一致する名前と説明を表示します。 |
| カテゴリセレクター | エージェントアプリカタログを絞り込みます。 | **すべて**を選択してカテゴリフィルターを削除します。 |
| **前へ**と**次へ** | 長いカタログを移動します。 | Runner は一致するアプリの前のページまたは次のページを表示します。 |
| アプリカード | アプリ名、説明、および接続状態を表示します。 | それを選択すると、**アプリの詳細**が開きます。 |
| **アプリが見つかりません** | 現在のフィルターに一致するものがないことを示します。 | **検索をクリア**すると、検索とカテゴリがリセットされます。 |
| 読み込みプレースホルダー | Runner がカタログを取得していることを示します。 | アプリを選択する前にカードを待ちます。 |

## アプリの詳細コントロール

| コントロールまたは状態 | 有用な理由 | 次に何が起こるか |
| --- | --- | --- |
| アプリの説明とカテゴリ | 意図したサービスを開いたことを確認するのに役立ちます。 | 詳細を表示しても外部アクセスは許可されません。 |
| ツールスイッチ | Runner が接続されたアプリに何をするよう要求できるかを制限します。 | 接続する前に、Runner は選択内容を接続と共に保存します。接続後、変更は直ちに保存されます。 |
| ツールリストの**前へ**と**次へ** | 多くのツールを持つアプリをレビューします。 | ダイアログを閉じずにツール間を移動します。 |
| 必須の認証情報フィールド | ブラウザ認可を使用しないアプリをサポートします。 | 必須フィールドが入力されるまで**接続**は利用できません。シークレットのようなフィールドはマスクされます。 |
| **接続** | その戦略が必要な場合、プロバイダー認証情報を送信します。 | Runner は選択したツールアクセスで接続を試みます。 |
| **接続して認可** | プロバイダー認可を開始します。 | Runner は認可ウィンドウを開きます。 |
| **接続中...** | 認可が進行中であることを示します。 | Runner が結果を受け取るまで、アクションは利用できません。 |
| **接続済み** | Runner がアカウントを認識していることを確認します。 | ダイアログを閉じるか、ツールアクセスを管理します。 |
| **管理** | 接続されたアプリを再度開きます。 | 有効なツールを確認して変更するか、切断します。 |
| **切断** | 削除を開始します。 | Runner は**本当に切断しますか?**と尋ねます。 |
| **キャンセル**または**確認** | 切断警告を解決します。 | キャンセルはアクセスを保持します。確認すると、Runner からアカウントレベルのエージェントアプリ接続が削除されます。プロジェクトツール設定は別です。 |

## エージェントアプリを接続する

1. **プロジェクト → アプリ**を開き、**エージェントアプリ**までスクロールします。
2. アプリを検索するか、カテゴリを選択します。
3. アプリカードを選択して、**アプリの詳細**を開きます。
4. その説明を読み、利用可能なすべてのツールを検査します。
5. Runner がこのプロジェクトで使用すべきではないツールをオフにします。
6. 必須のプロバイダー認証情報を入力するか、**接続して認可**を選択します。
7. プロバイダーステップを完了します。ブラウザが認可ウィンドウをブロックしている場合は、
   Runner のポップアップを許可して再度開始します。
8. ダイアログに戻り、**接続済み**と表示されていることを確認します。
9. 後で**管理**を選択して、ツールアクセスを確認するか、アプリを切断します。

接続ダイアログは、プロバイダー認証情報が接続サービスを通じて送信され、
Runner によって保存されないことを示しています。それでも、すべての認証情報をシークレットとして扱い、
アプリの認証情報フィールドにのみ入力する必要があります。

## ツールアクセスを変更する

1. 接続されたアプリで**管理**を選択します。
2. 変更するツールを見つけます。
3. そのスイッチをオンまたはオフにします。
4. **ツール有効**または**ツール無効**を待ちます。
5. Runner が**ツールの更新に失敗しました**と表示する場合は、ダイアログを開いたままにして、
   更新後に現在のスイッチを確認し、保存された状態が明確な場合のみ再試行します。

ツールを無効にすると、Runner のそのツールの使用が制限されます。外部サービスで以前に
作成されたデータは削除されません。

## 接続を修復または切断する

カタログに使用可能な接続が表示されなくなった場合は、アプリを開いて**接続**または
**接続して認可**を再度開始し、**接続済み**を確認します。

アクセスを削除するには、**管理 → 切断**を選択し、確認を確認して、
**確認**を選択します。これにより、現在のプロジェクトのツールアクセスだけでなく、
サインインしたアカウントのエージェントアプリ接続が削除されます。切断に失敗した場合、
Runner は接続された状態を保持します。外部アカウントが削除されたと仮定しないでください。

## エージェントアプリが見つからない場合

- この機能がワークスペースに対して有効になっていない可能性があります。
- 検索をクリアし、カテゴリを**すべて**に設定します。
- カタログが読み込み状態を離れない場合は、アプリを更新します。
- 個別のアプリは、まだ接続できないことを報告できます。
- ツールリストが失敗した場合は、**アプリの詳細**内で**再試行**を選択します。
- 特定のカタログエントリは、現在のワークスペースに表示されるまで約束されるべきではありません。

## 関連ガイド

- [アプリと統合の概要](../apps-and-integrations)
- [アプリを接続、管理、再接続する](./connect-manage-reconnect)
- [アプリ接続のトラブルシューティング](./troubleshooting)