ドキュメントアプリと統合
アプリと統合
Runner ストアとエージェントが使用できるサービスを見つけて、接続して、管理します。
アプリは、ストアサービスとオプションのエージェントアプリを 1 つの場所に集めます。Runner が支払いを受け入れたり、 ストアメールを送信したり、配送またはフルフィルメントプロバイダーと連携したり、Shopify を接続したり、 エージェントが別のサービスを使用できるようにしたい場合に使用します。
アプリを開く
開いているストアから、プロジェクトナビゲーションでアプリを選択します。
エントリパス: プロジェクト → アプリ
ページは 2 つのセクションを表示できます:
- ストアアプリには、ストアフロントとストア操作で使用されるサービスが含まれています。
- エージェントアプリには、Runner エージェントが作業中に使用できるサービスが含まれています。
エージェントアプリと Shopify は条件付きです。一部のワークスペースでは非表示または利用できない場合があります。 プロバイダー要件により、表示されたカードが接続されるのを防ぐこともできます。
ページコントロール
| コントロールまたは状態 | 有用な理由 | 次に何が起こるか |
|---|---|---|
| アプリを検索 | すべてのカードをスキャンせずにサービスを見つけます。 | Runner は両方の表示されたアプリセクションをフィルタリングします。フィールドをクリアするとリストが復元されます。 |
| 接続 | 新しい接続を開始します。 | Runner はプロバイダー固有の認証情報ダイアログまたは認可フローを開きます。カードが状態を変更するまで接続は完了しません。 |
| 接続中... | Runner がリクエストを処理していることを示します。 | リクエストが成功、失敗、または Runner の外でキャンセルされるまで、アクションは利用できません。 |
| 接続済みまたは接続されたアクション | Runner が接続を認識していることを確認します。 | プロバイダー固有のカードはダッシュボードリンク、切断コントロール、スイッチ、または管理ダイアログを公開できます。 |
| 管理 | 既存のエージェントアプリ接続を開きます。 | そのツールを確認するか、切断できます。 |
| 再接続 | 認可が再度必要な接続を修復します。 | Runner はプロバイダーの接続フローを再開します。 |
| レビュー待ち | Stripe がまだアカウントをレビューしていることを示します。 | ステータスが変更されるのを待つか、カードに表示されているアクション要求に従います。 |
| 削除または切断 | 確認後に接続を削除します。 | プロバイダー固有の警告は、どのプロジェクトと将来のアクションが影響を受けるかを説明します。 |
アプリを安全に接続する
- プロジェクト → アプリを開きます。
- サービスを検索するか、ストアアプリまたはエージェントアプリの下で見つけます。
- 接続を選択します。
- ドメイン、API キー、シークレット、またはプロバイダー認証情報を入力する前にダイアログを読みます。
- プロバイダーのサイトで認可ステップを完了します。
- アプリに戻り、カードを確認します。接続されたバッジまたは接続されたコントロールなどの 確認された接続状態のみを完了した接続として扱います。
- Runner が再接続、レビュー待ち、またはアクション通知を表示する場合は、 初期セットアップを盲目的に繰り返す代わりにその状態に従います。
API キーまたはシークレットを Runner チャットに貼り付けないでください。それらを要求する統合 ダイアログにのみ入力してください。