# 外部アプリをAgentsに接続する

Source: https://support.kapsulehost.com/ja-jp/agents-connections

## 接続とは何か

接続は、あなたの専門家の1人と1つの外部アプリとの間の署名付きリンクです。接続されると、その専門家は会話の中でアプリのツールを使用できます。ドキュメントを読む、メッセージを作成する、レコードを確認するなどです。接続がない場合、専門家はまったくアクセスできません。

2つの点について正確に理解する価値があります。

- 接続は**そのアプリへの**アクセスを許可し、KapsuleHostアカウントへのアクセスではありません。2つの権限セットが混在することはありません。
- 接続されたアプリで何かを**変更する**ことは、KapsuleHostアカウント上の変更と同じ確認カードを通じて行われます。読み取りは即座に行われ、書き込みはまず確認を求めます。

> **Note:** 接続は**エージェント**、次に**接続を管理**にあるか、`/agents/connections`に直接アクセスしてください。エージェントホームページには、いくつかのサンプルアプリが表示された接続カードも表示されます。

## どの専門家がどのアプリを使用できるか

名簿は意図的に慎重であり、各専門家はそのジョブに必要なアプリのみを表示します。アプリ自体がより多くのことを実行できる場合でも、一部は読み取り専用ツールに制限されています。

| 専門家 | アクセスできる外部アプリ |
|---|---|
| Mara、Business Advisor | Stripe（読み取り専用） |
| Thea、Creative Writer | Notion |
| Sef、SEO Consultant | GitHub（読み取り専用） |
| Mila、Marketing Planner | Gmail、Slack、Notion、Google Calendar |
| Iris、Customer Comms | Gmail、Slack |
| Ash、Sales and Outreach | Gmail、Slack、Stripe（読み取り専用） |
| Pip、Policy and Docs | なし |

アプリを接続しても、チーム全体に渡されることはありません。上の行の専門家のみが利用できるようになります。

![Kapsule Agentsの接続カタログ](https://support.kapsulehost.com/help/screenshots/agents-connections.26935fcd.webp)

## アプリの接続

1. **エージェント**を開き、次に**接続を管理**をクリックします。
2. **人気**タブを参照するか、**すべてのアプリ**に切り替えるか、検索ボックスに入力します。各カードはアプリ名と公開されているツール数を表示します。
3. 接続したいアプリの**接続**をクリックします。サインインウィンドウが準備されている間、ボタンは**開いています...**に変わります。
4. アプリ自体にサインインして、要求されるアクセスを承認します。
5. **[アプリ]接続完了**確認と共に接続ページに戻ります。

接続されると、カードは**接続完了**ピル、サインインしたアカウントラベル、および接続が最後に使用された時刻、または**まだ使用されていません**を表示します。

## 接続ステータス

| ステータス | 意味 | 対応方法 |
|---|---|---|
| 接続完了 | 動作中。専門家が使用できます。 | 何もしません |
| 保留中 | サインインが開始されましたが、完了していません。 | **接続を完了**をクリックしてください |
| 再接続が必要 | アクセスが期限切れになるか、アプリ側で取り消されました。 | **再接続**をクリックしてください |

**再接続が必要**の状態は時間の経過とともに正常です。ほとんどのアプリは、付与するアクセスをスケジュールに従って期限切れにします。再接続すると、何も失わずにアクセスが復元されます。

## これがどのように安全に保たれるか

接続ページは安全モデルを3行で述べており、読み飛ばすのではなく理解する価値があります。

- **認定パートナーによって処理されます。** アプリへのサインインは、認定統合パートナーによって処理され、許可を保持します。アプリパスワードがKapsuleHostに送られることはありません。
- **アクション前の確認。** エージェントは行動する前に確認を求めます。何かを変更するには、あなたの許可が必要です。
- **即座に失効します。** 接続を解除するとアクセスが直ちに切断され、アプリでも同じです。

> **Warning:** 接続を誰かのために切った鍵のように扱ってください。専門家が作業しているアカウントを接続し、自分が所有しているすべてのアカウントではなく、あなたが専門家にそのジョブを実行するために必要かどうか確実でない場合は、アプリを接続しないでください。まず確認してから接続してください。

## アプリの接続を解除

1. **エージェント**を開き、次に**接続を管理**をクリックします。
2. 接続されたアプリの**接続を解除**をクリックします。
3. 確認が表示されます。*チームはすぐに[アプリ]へのアクセスを失います。すでに使用されているすべてのコンテンツは過去のチャットに残ります。*
4. **接続を解除**をクリックして確認します。

アクセスは直ちに終了されます。これが**実行しない**のは、すでに行われた会話からアプリのコンテンツをスクラブすることです。専門家が先週のチャットにドキュメントを引用した場合、そのテキストはまだチャットトランスクリプトに含まれています。接続を解除することは、遡及的な消去ではなく、将来のアクセスについてです。

## アカウントで接続が利用できない場合

接続ページに**接続はまだ利用できません**と記載された単一の落ち着いたカードが表示される場合、外部アプリの接続がアカウントで有効になっていません。カードは何も接続されておらず、アクセス権がないことを明確に述べています。これは、その状態にある正確な真実です。専門家はまだ機能しています。彼らはKapsuleHostの外に到達することはできません。

エージェントの残りの部分は影響を受けません。チャット、[スキル](https://support.kapsulehost.com/ja-jp/agents-skills)およびアカウント読み取りはすべて通常通り動作します。

## 失敗した場合はどうしますか

**「アプリ自体の承認画面で許可が与えられなかったため、何も接続されていません。」** キャンセルするか拒否しました。何も作成されていません。**接続**をもう一度クリックして、アクセスを承認してください。

**「接続は現在利用できません。後でもう一度試してください。」** 統合サービスに接続できませんでした。これは意図的にフェイルクローズされています。半構築リストを表示するのではなく、ページは何も表示しません。1分待ってリロードしてください。

**「接続をロードできませんでした。」** 設定は安全です。ページを更新してください。問題が解決しない場合は、[サポートチケットを開いてください](https://support.kapsulehost.com/ja-jp/opening-a-support-ticket)。

**専門家は接続されたアプリに到達できないと言っています。** 上の表を確認してください。すべての専門家がすべてのアプリを許可されているわけではなく、Irisについて接続されたアプリはMaraで自動的に利用可能ではありません。

**接続は保留中のままです。** サインインウィンドウが完了する前に閉じられました。**接続を完了**をクリックして完了してください。

## 接続にかかるコスト

会話で接続されたアプリを使用することは、他のジョブと同様に測定されます。専門家が外部アプリに対して行う各呼び出しは、接続呼び出しの重みで課金され、これは長いテキストの費用の一部です。KapsuleHostアカウントの読み取りは無料のままです。完全な重み付けは[エージェントクレジットの仕組み](https://support.kapsulehost.com/ja-jp/agents-credits)にあります。

## 関連記事

- [Kapsuleエージェント概要](https://support.kapsulehost.com/ja-jp/agents-overview)
- [Kapsule Agentsを始める](https://support.kapsulehost.com/ja-jp/agents-getting-started)
- [エージェントスキルの使用方法](https://support.kapsulehost.com/ja-jp/agents-skills)