> ## 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 复制粘贴数据到 Trellis，您只需告诉助手您需要什么，它就会登录、找到信息并带回来。

***

## 工作原理

<Steps>
  <Step title="添加网站凭据">
    前往 **知识库 > Agents**，选择对应的 agent，打开 **Integrations** 标签，然后点击**连接网站**。输入网站域名（或从 Airbnb、Booking.com、Guesty、Breezeway、Hostaway 或 Krossbooking 等建议网站中选择）、您的邮箱或用户名，以及密码。
  </Step>

  <Step title="验证凭据">
    点击**验证**，让 AI 助手测试登录。系统会打开一个安全的云端浏览器，助手自动输入您的凭据。您可以通过实时视图窗口观看整个登录过程。
  </Step>

  <Step title="处理双重认证">
    如果网站需要验证器应用中的验证码，助手会暂停并等待您完成双重认证步骤。您也可以添加 TOTP 验证器密钥，让助手自动处理双重认证验证码 - 无需手动操作。
  </Step>

  <Step title="助手使用您的凭据">
    验证通过后，助手在需要访问该网站时会重复使用已保存的会话。Cookie 会跨会话保留，因此助手无需每次都重新登录。
  </Step>
</Steps>

***

## 添加凭据

在该 agent 的 **Integrations** 标签，点击**连接网站**添加新凭据。

| 字段         | 说明                                               |
| ---------- | ------------------------------------------------ |
| **网站**     | 要登录的域名（例如 airbnb.com、booking.com）。从建议中选择或输入任意域名。 |
| **邮箱或用户名** | 您在该网站的登录信息。如果输入邮箱地址，登录时会同时用作邮箱和用户名字段。            |
| **密码**     | 您在该网站的密码。加密存储 - 助手仅在登录过程中使用。                     |
| **验证器密钥**  | 可选。来自验证器应用设置的 TOTP 密钥。提供后，助手会自动生成双重认证验证码。        |

<Tip>
  要找到您的验证器密钥，请在验证器应用（Google Authenticator、Authy、1Password 等）中添加新账户时查找"设置密钥"或"密钥"选项。它通常是一串较长的字母数字字符串。
</Tip>

***

## 凭据状态

每个凭据都显示状态，让您一目了然地知道助手是否能访问该网站。

| 状态        | 含义                                |
| --------- | --------------------------------- |
| **就绪**    | 凭据已验证，助手可以成功登录。                   |
| **未连接**   | 凭据尚未验证，或最近已更改。点击**验证**进行测试。       |
| **需要验证码** | 网站需要助手无法生成的双重认证验证码。添加您的验证器密钥即可解决。 |
| **失败**    | 上次登录尝试失败。请更新凭据并重新验证。              |

当助手在聊天任务中使用凭据时 - 例如登录 Airbnb 查看房源 - 状态会根据登录是否成功自动更新。

***

## 双重认证

许多旅游平台要求双重认证。关联账户通过两种方式处理：

<Tabs>
  <Tab title="自动双重认证">
    在创建凭据时添加您的 TOTP 验证器密钥。助手在登录时自动生成基于时间的验证码 - 无需手动步骤。对于您经常访问的网站，推荐使用此方式。
  </Tab>

  <Tab title="手动双重认证">
    如果您未添加验证器密钥，助手在遇到双重认证提示时会暂停并打开实时浏览器视图。您直接在浏览器中输入验证器应用中的验证码，助手在您通过双重认证步骤后继续操作。
  </Tab>
</Tabs>

<Note>
  验证器密钥在静态存储时加密，并限定于特定域名 - 它永远不会暴露给其他网站，也不会在登录流程之外使用。
</Note>

***

## 实时浏览器视图

当助手打开浏览器登录网站或执行任务时，您可以通过实时视图窗口观看整个会话过程。这适用于：

* **验证凭据** - 观看助手填写登录信息并确认其正常工作
* **处理双重认证提示** - 在助手暂停时直接在实时浏览器中输入验证码
* **监控任务** - 准确查看助手在外部网站上正在做什么

实时视图会在凭据验证期间以及助手遇到需要您输入的步骤时自动出现。

***

## 聊天中的浏览器会话

当您让 AI 助手执行需要访问网站的操作 - 例如"查看我 4B 单元的 Airbnb 房源"或"从 Booking.com 提取最新的付款报告" - 聊天中会出现一个浏览器会话卡片。

会话卡片显示：

* **逐步进度** - 助手执行的每个操作（导航到页面、点击按钮、读取内容）都会作为带时间戳的步骤显示
* **截图** - 助手在工作时捕获截图，让您看到它看到的内容
* **实时视图** - 点击可在浏览器会话运行时打开实时视图
* **最终结果** - 任务完成后，助手总结发现的内容并将其包含在聊天中

<Tip>
  如果助手在浏览器会话中遇到问题 - 例如意外的弹窗或页面布局变化 - 它会暂停，您可以通过实时视图接管操作，帮助它越过障碍。
</Tip>

***

## 建议网站

添加凭据时，Trellis 会建议酒店和物业管理中常用的域名：

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

您也可以输入任意域名，将助手连接到列表之外的网站。

***

## 管理凭据

在该 agent 的 **Integrations** 标签，您可以：

* **编辑**凭据以更新用户名、密码或验证器密钥
* **重新验证**凭据，在更改后确认助手仍能登录
* **删除**凭据以移除助手对该网站的访问权限

<Note>
  更新您的邮箱、用户名或验证器密钥会自动将凭据状态重置为"未连接"。更改后请重新验证。
</Note>

***

## 常见问题

<AccordionGroup>
  <Accordion title="我的密码安全吗？">
    凭据在静态存储时加密，并限定于特定域名。助手仅在该域名的登录过程中解密 - 它们永远不会暴露给其他网站、其他用户或其他工作区。
  </Accordion>

  <Accordion title="助手会存储我的会话 Cookie 吗？">
    是的。成功登录后，助手会保存会话 Cookie，这样就无需每次都重新输入凭据。这就像在普通浏览器中保持登录状态一样。
  </Accordion>

  <Accordion title="如果我的密码更改了怎么办？">
    下次助手尝试登录时，凭据状态会变为"失败"。在该 agent 的 Integrations 标签更新密码并重新验证。
  </Accordion>

  <Accordion title="不同的团队成员可以有各自的凭据吗？">
    凭据与 AI 助手绑定，而非与个别团队成员绑定。工作区中的所有团队成员共享每个助手的同一组关联账户。
  </Accordion>

  <Accordion title="哪些网站支持此功能？">
    助手可以登录大多数使用标准邮箱/密码登录表单的网站。使用特殊登录流程的网站（如银行级安全措施或硬件令牌要求）可能无法可靠运行。
  </Accordion>
</AccordionGroup>