エージェントアプリを接続して制御する

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

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

開始する前に

アクセス方法: プロジェクト → アプリ → ツールを接続

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

必要なもの:

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

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

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

ツールを接続でアプリを開き、ツール一覧を読みます。比較するだけなら詳細を閉じます。承認は別の判断であり、ツールの確認だけでは外部アカウントは接続されません。

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

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

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

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

英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。

次へで1ページずつ確認します。一覧を開いてもNotionは承認されません。接続して認証で別の手順を始めます。画像は英語の画面です。

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

プロジェクト → アプリ → ツールを接続を開きます。
アプリを検索するかカテゴリを選びます。
カードからアプリの詳細を開きます。
説明と全ツールを確認します。
このプロジェクトで使わないツールをオフにします。
必要な認証情報を入力するか接続して認証を選びます。
提供元の手順を完了します。承認ウィンドウがブロックされた場合はRunnerのポップアップを許可して再開します。
戻って接続済みを確認します。
後で管理からツール権限や接続解除を確認できます。

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

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

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

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

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

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

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

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

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