> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trellistech.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 接続済みアカウント

> ウェブサイトの認証情報を保存して、AIエージェントがAirbnb、Booking.comなどのプラットフォームに代理ログインできるようにします

## AIエージェントにウェブ閲覧を任せましょう

AIエージェントは外部ウェブサイトにアクセスできます - OTAリスティングの確認、レポートの取得、料金の検証など - しかし、多くのサイトではログインが必要です。接続済みアカウントを使えば、認証情報を一度保存するだけで、エージェントがサイトにアクセスする必要があるときに自動的にサインインできます。

AirbnbやBooking.comからデータをコピー＆ペーストする代わりに、必要な情報をエージェントに伝えるだけで、エージェントがログインし、情報を見つけて持ち帰ります。

***

## 仕組み

<Steps>
  <Step title="ウェブサイトの認証情報を追加">
    **ナレッジベース > Agents** に移動し、対象の agent を選択して **Integrations** タブを開き、**ウェブサイトを接続**をクリックします。サイトのドメインを入力（または Airbnb、Booking.com、Guesty、Breezeway、Hostaway、Krossbooking などの候補から選択）し、メールアドレスまたはユーザー名、パスワードを入力します。
  </Step>

  <Step title="認証情報を検証">
    **検証**をクリックすると、AIエージェントがログインをテストします。安全なクラウドブラウザが開き、エージェントが自動的に認証情報を入力します。ライブビューウィンドウでログインの様子をリアルタイムで確認できます。
  </Step>

  <Step title="二要素認証の処理">
    サイトが認証アプリからのコードを要求する場合、エージェントは一時停止し、2FAステップの完了を待ちます。TOTPオーセンティケーターシークレットを追加すると、エージェントが2FAコードを自動的に処理するため、手動操作は不要です。
  </Step>

  <Step title="エージェントが認証情報を使用">
    検証が完了すると、エージェントはそのサイトにアクセスする必要があるたびに保存されたセッションを再利用します。Cookieはセッション間で保持されるため、毎回ログインする必要はありません。
  </Step>
</Steps>

***

## 認証情報の追加

agent の **Integrations** タブから**ウェブサイトを接続**をクリックして、新しい認証情報を追加します。

| フィールド                | 説明                                                                |
| -------------------- | ----------------------------------------------------------------- |
| **ウェブサイト**           | ログイン先のドメイン（例：airbnb.com、booking.com）。候補から選択するか、任意のドメインを入力できます。    |
| **メールアドレスまたはユーザー名**  | サイトのログイン情報。メールアドレスを入力した場合、サインイン時にメールフィールドとユーザー名フィールドの両方に使用されます。   |
| **パスワード**            | サイトのパスワード。暗号化して保存され、エージェントはログインプロセス中にのみ使用します。                     |
| **オーセンティケーターシークレット** | オプション。認証アプリのセットアップ時に取得するTOTPシークレット。設定すると、エージェントが2FAコードを自動的に生成します。 |

<Tip>
  オーセンティケーターシークレットを見つけるには、認証アプリ（Google Authenticator、Authy、1Passwordなど）で新しいアカウントを追加する際に「セットアップキー」または「シークレットキー」オプションを探してください。通常、長い英数字の文字列です。
</Tip>

***

## 認証情報のステータス

各認証情報にはステータスが表示され、エージェントがそのサイトにアクセスできるかどうかを一目で確認できます。

| ステータス      | 意味                                                             |
| ---------- | -------------------------------------------------------------- |
| **準備完了**   | 認証情報が検証済みで、エージェントは正常にログインできます。                                 |
| **未接続**    | 認証情報がまだ検証されていないか、最近変更されました。**検証**をクリックしてテストしてください。             |
| **コードが必要** | サイトがエージェントで生成できない2FAコードを要求しています。オーセンティケーターシークレットを追加して解決してください。 |
| **失敗**     | 最後のログイン試行が失敗しました。認証情報を更新して再検証してください。                           |

エージェントがチャットタスク中に認証情報を使用する場合（例：Airbnbにログインしてリスティングを確認する）、ログインの成否に基づいてステータスが自動的に更新されます。

***

## 二要素認証

多くの旅行プラットフォームでは二要素認証が必要です。接続済みアカウントでは、これを2つの方法で処理します：

<Tabs>
  <Tab title="自動2FA">
    認証情報の作成時にTOTPオーセンティケーターシークレットを追加します。エージェントがログイン時にタイムベースのコードを自動的に生成するため、手動操作は不要です。頻繁にアクセスするサイトには、この方法を推奨します。
  </Tab>

  <Tab title="手動2FA">
    オーセンティケーターシークレットを追加しない場合、エージェントは2FAプロンプトに遭遇すると一時停止し、ライブブラウザビューを開きます。認証アプリからのコードをブラウザに直接入力すると、2FAステップが完了した後にエージェントが処理を続行します。
  </Tab>
</Tabs>

<Note>
  オーセンティケーターシークレットは保存時に暗号化され、特定のドメインにスコープされます。他のサイトに公開されたり、ログインフロー以外で使用されることはありません。
</Note>

***

## ライブブラウザビュー

エージェントがサイトにログインしたりタスクを実行するためにブラウザを開くと、ライブビューウィンドウでセッションをリアルタイムで確認できます。以下の場合に便利です：

* **認証情報の検証** - エージェントがログイン情報を入力し、正常に動作することを確認できます
* **2FAプロンプトの処理** - エージェントが一時停止した際に、ライブブラウザにコードを直接入力できます
* **タスクの監視** - エージェントが外部サイトで何をしているかを正確に確認できます

ライブビューは、認証情報の検証中やエージェントが入力を必要とするステップに遭遇した際に自動的に表示されます。

***

## チャット内のブラウザセッション

AIエージェントにウェブサイトへのアクセスが必要な操作を依頼すると（「ユニット4BのAirbnbリスティングを確認して」や「Booking.comから最新の支払いレポートを取得して」など）、チャット内にブラウザセッションカードが表示されます。

セッションカードには以下が表示されます：

* **ステップごとの進捗** - エージェントが行う各アクション（ページへの移動、ボタンのクリック、コンテンツの読み取り）がタイムスタンプ付きのステップとして表示されます
* **スクリーンショット** - エージェントが作業中にスクリーンショットをキャプチャするため、エージェントが見た画面を確認できます
* **ライブビュー** - クリックすると、実行中のブラウザセッションをリアルタイムで表示します
* **最終結果** - タスクが完了すると、エージェントが見つけた内容を要約してチャットに含めます

<Tip>
  ブラウザセッション中にエージェントが問題に遭遇した場合（予期しないポップアップやページレイアウトの変更など）、エージェントは一時停止し、ライブビューを通じて操作を引き継いで障害を乗り越える手助けができます。
</Tip>

***

## おすすめサイト

認証情報を追加する際、Trellisはホスピタリティおよび不動産管理でよく使用されるドメインを提案します：

* Airbnb
* Booking.com
* Guesty
* Breezeway
* Hostaway
* Krossbooking

リストにないサイトにエージェントを接続するために、任意のドメインを入力することもできます。

***

## 認証情報の管理

agent の **Integrations** タブから、以下の操作が可能です：

* **編集** - ユーザー名、パスワード、またはオーセンティケーターシークレットを更新します
* **再検証** - 変更後に認証情報を確認し、エージェントが引き続きログインできることを確認します
* **削除** - そのサイトへのエージェントのアクセスを削除します

<Note>
  メールアドレス、ユーザー名、またはオーセンティケーターシークレットを更新すると、認証情報のステータスは自動的に「未接続」にリセットされます。変更後は再検証してください。
</Note>

***

## FAQ

<AccordionGroup>
  <Accordion title="パスワードは安全ですか？">
    認証情報は保存時に暗号化され、特定のドメインにスコープされます。エージェントはそのドメインのログインプロセス中にのみ復号します。他のサイト、他のユーザー、他のワークスペースに公開されることはありません。
  </Accordion>

  <Accordion title="エージェントはセッションCookieを保存しますか？">
    はい。ログインに成功すると、エージェントはセッションCookieを保存するため、毎回認証情報を再入力する必要はありません。通常のブラウザでログイン状態を維持するのと同じ仕組みです。
  </Accordion>

  <Accordion title="パスワードを変更した場合はどうなりますか？">
    次にエージェントがログインを試みた際に、認証情報のステータスが「失敗」に変わります。agent の Integrations タブでパスワードを更新し、再検証してください。
  </Accordion>

  <Accordion title="チームメンバーごとに別々の認証情報を持てますか？">
    認証情報はAIエージェントに紐づいており、個々のチームメンバーには紐づいていません。ワークスペース内のすべてのチームメンバーが、各エージェントの同じ接続済みアカウントセットを共有します。
  </Accordion>

  <Accordion title="どのサイトで使用できますか？">
    エージェントは、標準的なメール/パスワードのログインフォームを使用するほとんどのウェブサイトにログインできます。銀行レベルのセキュリティやハードウェアトークンの要件があるなど、特殊なログインフローを持つサイトでは、安定して動作しない場合があります。
  </Accordion>
</AccordionGroup>