はじめに
外部アプリをエージェントに接続する
Connections let a Kapsule Agents expert work inside apps you already use, with your permission, and they are entirely separate from what an expert can do on your Kapsule account.
コネクションとは
コネクションは、あなたの許可のもとで、Kapsule Agentsの専門家が1人と外部アプリ1つの間に築かれたサインイン済みのリンクです。コネクションが確立されると、その専門家はコンバーセーション内でアプリのツールを使用できるようになります。ドキュメントを読んだり、メッセージを下書きしたり、レコードを確認したりできます。コネクションがなければ、専門家はまったくアクセスできません。
正確に理解しておくべき2つのポイントがあります。
- コネクションはそのアプリへのアクセス権を付与するもので、Kapsuleアカウントへのアクセス権ではありません。この2つの権限セットが混在することはありません。
- コネクションされたアプリで何かを変更するようなアクションは、Kapsuleアカウント内での変更と同じ確認カードを経由します。読み取りは即座に実行され、書き込みは事前に許可を求めます。
コネクションはAgentsからManage Connectionsで管理するか、/agents/connectionsに直接アクセスできます。Agentsホームページにはコネクションカードがあり、サンプルアプリが表示されています。
どの専門家がどのアプリを使用できるか
ラインナップは意図的に保守的であり、各専門家は自分の職務に必要なアプリのみ表示されます。アプリ自体がより多くの機能を提供している場合でも、読み取り専用に制限されているものもあります。
| 専門家 | アクセス可能な外部アプリ |
|---|---|
| Mara, Business Advisor | Stripe（読み取り専用） |
| Thea, Creative Writer | Notion |
| Sef, SEO Consultant | GitHub（読み取り専用） |
| Mila, Marketing Planner | Gmail、Slack、Notion、Google Calendar |
| Cora, Customer Comms | Gmail、Slack |
| Ash, Sales and Outreach | Gmail、Slack、Stripe（読み取り専用） |
| Pip, Policy and Docs | なし |
アプリをコネクトしてもチーム全体で使用可能になるわけではありません。上の表に記載されている専門家のみが利用できるようになります。
アプリをコネクトする
- Agentsを開き、Manage Connectionsを選択します。
- Popularタブを参照するか、All Appsに切り替えるか、検索ボックスに入力します。各カードにはアプリ名とそれが公開するツールの数が表示されます。
- 接続したいアプリのConnectをクリックします。サインインウィンドウが準備される間、ボタンは**Opening...**に変わります。
- アプリ自体にサインインして、要求されたアクセスを承認します。
- コネクションページに戻り、[app] Connectedという確認が表示されます。
コネクション後、カードにはConnectedピル、サインインしたアカウントラベル、コネクションが最後に使用された時刻、またはまだ使用されていない場合はNot used yetが表示されます。
コネクションステータス
| ステータス | 意味 | 対応方法 |
|---|---|---|
| Connected | 機能しています。専門家が使用できます。 | 対応不要 |
| Pending | サインインが開始されましたが完了していません。 | Finish Connectingをクリック |
| Reconnect Needed | アクセスの有効期限が切れたか、アプリ側で取り消されました。 | Reconnectをクリック |
Reconnect Neededの状態は時間とともに起こる通常のことです。ほとんどのアプリはスケジュールに従ってアクセス権を有効期限切れにします。再接続することで、何も失うことなくアクセスを復元できます。
セキュリティをどのように維持するか
コネクションページは安全性モデルを3行で述べており、流し読みするのではなく理解する価値があります。
- 認定パートナーによって処理されます。 アプリへのサインインは、当社の認定統合パートナーによって処理され、パートナーがアクセス権を保持します。アプリパスワードはKapsuleに渡されません。
- アクション前に確認します。 Agentsは実行する前に許可を求めます。何かを変更するアクションはすべて事前の許可が必要です。
- 即座に取り消し可能。 コネクトを解除すると、こことアプリの両方でアクセスがすぐに遮断されます。
コネクションを誰かのために切った鍵のようなものと考えてください。専門家に作業してもらいたいアカウントをコネクトし、所有するすべてのアカウントをコネクトするわけではありません。専門家がその仕事を完遂するためにアプリが必要かどうかが不明な場合は、コネクトしないでください。まず確認してからコネクトしてください。
アプリをディスコネクトする
- Agentsを開き、Manage Connectionsを選択します。
- コネクション済みアプリのDisconnectをクリックします。
- 確認が表示されます。Your team loses access to [app] right away. Anything it has already used stays in your past chats.(チームは[app]へのアクセスをすぐに失います。既に使用されたすべての内容は過去のチャットに残ります。)
- Disconnectをクリックして確認します。
アクセスはすぐに終了します。これがしないことは、既に行われたコンバーセーションからアプリのコンテンツを削除することです。専門家が先週チャットにドキュメントを引用していた場合、そのテキストはチャットトランスクリプトに残ります。ディスコネクトは将来のアクセスに関するもので、遡及的な削除ではありません。
アカウントでコネクションが利用できない場合
コネクションページにConnections Are Not Available Yetと表示された1つの落ち着いたカードのみが表示されている場合は、外部アプリのコネクトがアカウントでまだ有効になっていません。カードには何もコネクトされておらず、何もアクセスできないことが明示されており、それがその状態の正確な事実です。専門家は引き続き作業できます。ただし、Kapsule外に到達することはできません。
Agentsの残りの部分は影響を受けません。チャット、スキル、アカウント読み取りはすべて通常通り動作します。
失敗する場合
「Permission was not granted, so nothing was connected.」(権限が付与されなかったため、何もコネクトされていません。) アプリ自体の承認画面でキャンセルまたは拒否しました。何も作成されていません。もう一度Connectをクリックしてアクセスを承認します。
「Connections are unavailable right now. Try again in a moment.」(コネクションは現在利用できません。しばらくしてからもう一度試してください。) 統合サービスに到達できませんでした。これは意図的にフェイルセーフです。半分作成されたリストを表示するのではなく、ページは何も表示しません。1分待ってからリロードします。
「Connections could not be loaded.」(コネクションを読み込めませんでした。) 設定は安全です。ページを更新してください。それでも続く場合は、サポートチケットを開いてください。
専門家がコネクトされたアプリに到達できないと言っています。 上の表を確認してください。すべての専門家がすべてのアプリを使用できるわけではなく、Coraのためにコネクトされたアプリは自動的にMaraに利用可能になるわけではありません。
コネクションがPendingのままです。 サインインウィンドウが完了する前に閉じられました。Finish Connectingをクリックして完了します。
コネクション使用料
コンバーセーション内でコネクトされたアプリを使用することは、他のジョブと同じように計測されます。専門家が外部アプリに行う各呼び出しは、コネクション呼び出し重みで課金されます。これは長い文章の作成にかかるコストの一部です。Kapsuleアカウントの読み取りは無料のままです。完全な重みはHow Agent Credits Workにあります。