> ## 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.

# 自动化

> 自动化房产管理中的重复性工作 - 消息、任务创建、升级等

## 停止重复做同样的事情

每位房产管理者都有每周重复几十次的任务：发送入住说明、退房后创建清洁任务、通知团队处理问题。自动化为您处理这些 - 可靠地，每一次。

***

## 可以自动化什么？

<CardGroup cols={2}>
  <Card title="宾客消息" icon="message">
    自动按每个预订的时间发送入住说明、退房提醒、评价请求和后续跟进。
  </Card>

  <Card title="任务创建" icon="clipboard-list" href="/zh/platform/tasks">
    在特定事件发生时创建按部门归类的[任务](/zh/platform/tasks) - 如宾客退房或新预订。
  </Card>

  <Card title="升级提醒" icon="bell">
    当需要人工处理时立即通知经理 - 投诉、退款请求或 AI 无法处理的对话。
  </Card>

  <Card title="业主报告" icon="chart-bar">
    按您选择的时间表，向房产业主发送预订、收入和维护活动的自动摘要。
  </Card>

  <Card title="团队通知" icon="users">
    在任务分配、对话升级或紧急问题发生时提醒您的团队。
  </Card>

  <Card title="数据更新" icon="arrows-rotate">
    根据您定义的条件自动更新记录、更改状态或标记对话。
  </Card>
</CardGroup>

***

## 自动化的工作原理

每个自动化都有三个部分：**触发器**（什么启动它）、可选的**条件**（何时运行）和**操作**（做什么）。

### 触发器 - 什么启动自动化

<Tabs>
  <Tab title="基于事件">
    Trellis 中发生某事时自动化运行：

    * 创建新预订
    * 宾客入住或退房
    * 对话被升级
    * 任务完成
    * 收到新消息

    这是最常见的类型。例如："宾客退房时，创建清洁任务。"
  </Tab>

  <Tab title="定时">
    自动化按定期计划运行：

    * 每天早上 8 点
    * 每周一上午 9 点
    * 每月 1 日

    适合周报、每日任务摘要或定期提醒。

    <Warning>
      定时自动化需要在触发器配置中设置**时区**。如果您的自动化使用日期或时间值（如今天的日期、当前时间或明天等相对日期），Trellis 会在保存时显示错误，除非已设置时区。这确保日期和时间始终根据您的位置正确计算。
    </Warning>
  </Tab>

  <Tab title="手动">
    从 Trellis 界面手动启动自动化。适用于偶尔需要但不需要自动执行的工作流 - 如向所有即将入住的宾客批量发送季节性消息。
  </Tab>
</Tabs>

### 条件 - 何时运行

添加条件使自动化更智能。例如：

* 仅在特定房产退房时创建清洁任务
* 仅在预订已确认（未取消）时发送入住消息
* 仅在宾客提到特定关键词时升级

条件让您用一个自动化智能地处理多种场景。

### 操作 - 做什么

操作是自动化执行的步骤。您可以将多个操作串联起来：

| 操作           | 说明                                             |
| ------------ | ---------------------------------------------- |
| **发送消息**     | 通过任何渠道向宾客、业主或供应商发送模板化消息                        |
| **创建任务**     | 创建预填详情的部门任务                                    |
| **更新记录**     | 更改房产、预订、任务或对话的状态、负责人或任何字段                      |
| **通知团队**     | 向特定团队成员或角色发送通知                                 |
| **等待**       | 暂停自动化一段时间、等到特定日期或等到某事发生                        |
| **请求审批**     | 暂停并请求经理审核后再继续 - 适合高风险操作                        |
| **运行 AI 助手** | 让 [AI 助手](/zh/platform/ai-agent)分析情况、起草回复或做出决策 |

<Tip>
  当您添加带有结构化输出的 **AI 助手**步骤时，Trellis 会在保存前验证您的配置。它检查超时值是否足够长、引用的上下文是否可用、循环变量是否仅在循环内使用。修复所有警告以避免运行时的意外失败。
</Tip>

***

## 人工审批环节

某些自动化不应完全自动运行。**审批**步骤会暂停工作流并要求团队成员在继续前进行审核。

<Steps>
  <Step title="自动化到达审批步骤">
    工作流暂停，创建一个在[收件箱](/zh/platform/inbox)中可见的审批请求。
  </Step>

  <Step title="通知审核人">
    指定的审核人收到通知，附带做决定所需的所有上下文。
  </Step>

  <Step title="批准或拒绝">
    审核人批准操作（自动化继续）或拒绝（自动化停止或走替代路径）。
  </Step>
</Steps>

**何时使用审批：**

* 发送敏感话题（退款、政策变更）的消息之前
* 创建昂贵的维护任务之前
* 发送包含财务数据的业主报告之前
* 在自动流程中需要设置人工检查点时

***

## 从模板开始

无需从零开始构建自动化。Trellis 提供了最常见房产管理工作流的预建模板：

<AccordionGroup>
  <Accordion title="宾客入住消息">
    **触发器：** 入住前 24 小时
    **操作：** 向宾客发送入住说明，包括房产地址、门锁密码、Wi-Fi 密码、停车信息和房屋规则。房产详情自动填充。
  </Accordion>

  <Accordion title="退房清洁任务">
    **触发器：** 宾客退房
    **操作：** 为房产创建清洁任务，分配给默认清洁人员，附加标准周转检查清单，截止日期设为当天。
  </Accordion>

  <Accordion title="升级通知">
    **触发器：** 对话被升级（由 AI 或手动）
    **操作：** 立即向值班经理发送通知，附带对话摘要、宾客详情和对话链接。
  </Accordion>

  <Accordion title="业主月度报告">
    **触发器：** 每月 1 日
    **操作：** 汇总每个房产上月的预订数量、收入、入住率和维护成本。将摘要发送给房产业主。
  </Accordion>

  <Accordion title="评价请求">
    **触发器：** 退房后 1 天
    **操作：** 向宾客发送友好消息，感谢入住并请求留下评价。仅在入住期间没有升级问题时发送。
  </Accordion>

  <Accordion title="来自宾客消息的维护提醒">
    **触发器：** AI 在宾客消息中检测到维护问题
    **操作：** 创建维护任务，分配给值班维护人员，并通知房产经理。
  </Accordion>
</AccordionGroup>

***

## 构建自定义自动化

自动化构建器使用可视化画布，让您一目了然地查看整个工作流。左侧可折叠的侧边栏让您在工作流列表和画布之间切换，需要时有更多工作空间。

<Steps>
  <Step title="前往自动化">
    导航到左侧边栏的**自动化**，点击**新建自动化**。
  </Step>

  <Step title="选择触发器">
    选择启动自动化的方式 - 事件（如退房）、计划（如每周一）或手动。点击画布上的触发器节点在详情面板中配置。
  </Step>

  <Step title="添加条件（可选）">
    缩小自动化运行的范围。例如，仅限特定房产、预订来源或宾客类型。
  </Step>

  <Step title="添加操作">
    定义自动化要做什么。添加所需数量的步骤 - 发送消息、创建任务、等待、通知等。点击画布上的任何步骤打开其详情面板进行配置。步骤按顺序执行。
  </Step>

  <Step title="立即运行或激活">
    准备好后，点击**立即运行**立即执行自动化，或打开开关启用自动执行。使用顶部的**构建器**、**运行**和**版本**标签在设计、监控和查看历史版本之间切换。
  </Step>
</Steps>

<Tip>
  Trellis 在保存时验证您的工作流。如果条件或转换步骤引用了未声明的输入，或定时自动化在未配置时区的情况下使用日期和时间值，您会立即看到错误 - 这样可以在工作流运行前修复问题。
</Tip>

<Warning>
  在将新自动化推广到整个投资组合之前，先用单个房产或预订进行测试。这有助于在影响宾客之前发现问题。
</Warning>

***

## 监控自动化运行

自动化运行后，您可以从**运行**标签查看确切的执行情况。每次运行显示其状态、完成的步骤和发生的错误。

### 列表和日历视图

运行标签提供两种查看自动化历史的方式：

* **列表视图** - 默认表格，将每次运行显示为一行，包含状态、步骤进度、触发器类型和时间戳。默认显示过去 7 天的运行。可使用内联日历随时调整日期范围。适合扫描近期活动和按状态筛选。
* **日历视图** - 月历视图，按日期绘制运行。使用运行列表顶部的切换开关。用左右箭头在月份间导航，点击任何一天查看该天执行的运行。

<Tip>
  日历视图对定时自动化特别有用。一目了然即可确认每日或每周工作流是否在预期日期运行 - 并发现错过的运行。
</Tip>

### 筛选运行

使用运行列表顶部的筛选选项快速找到特定运行。筛选器适用于列表和日历视图：

* **状态** - 使用状态标签筛选排队中、运行中、已完成、失败或已取消的运行
* **日期范围** - 使用内联日历选择开始和结束日期。默认显示过去 7 天的运行
* **触发器类型** - 仅显示由特定触发器（事件、计划或手动）启动的运行
* **模拟运行** - 显示或隐藏测试运行（标有烧瓶图标），以便专注于实际执行或单独查看测试结果

### 运行详情

点击任意运行可在画布上查看逐步详细信息。每个步骤显示是否成功、失败或已跳过，以及其输出。运行列表中的**步骤进度**列为您快速提供每次运行在完成或遇到错误之前进展了多远的可视摘要。

详情侧边栏会在画布旁打开，让您可以在不丢失整个工作流视图的情况下检查每个步骤。

#### 步骤摘要

点击画布上的步骤即可在侧边栏中打开其摘要。每种步骤类型会显示针对其功能定制的信息：

* **触发器步骤** - 显示触发器类型（手动、基于事件、由 AI 启动或定时）以及启动运行的事件
* **条件步骤** - 以清晰的标签显示条件被评估为真还是假
* **操作步骤** - 列出该步骤影响的实体，如预订、任务、物业或联系人
* **循环步骤** - 显示正在迭代的实体以及处理了多少项目

#### 关联实体

当某个步骤涉及预订、任务、物业或联系人时，侧边栏会显示可点击的实体行，一目了然地展示关键详情 - 例如，预订行显示房客姓名和入住/退房日期。点击任意实体行即可直接跳转到 Trellis 中的该记录。

#### 详情标签页

切换到侧边栏中的**详情**标签页，查看任意步骤更深入的执行信息。对于使用 AI 代理的步骤，此标签页包含性能指标和代理操作的时间线。底部的运行级执行日志按时间顺序显示每个步骤，方便追踪完整的事件序列。

### 运行详情侧边栏

查看运行时，画布旁会打开一个详情侧边栏。它让您无需离开页面即可全面了解发生了什么。

**摘要标签页**

摘要标签页一目了然地显示自动化涉及了什么：

* **实体行** - 运行中涉及的预订、任务、物业和联系人以可点击的行显示。每行显示关键详情（如预订的房客姓名、入住和退房日期，或任务的标题和状态），方便您快速识别受影响的记录并点击查看更多。
* **触发器摘要** - 查看启动运行的是什么：手动触发器、定时运行、基于事件的触发器或由 AI 启动的操作。
* **逐步结果** - 每个步骤显示其类型标签、名称、持续时间和结果。条件步骤显示评估为真还是假。循环步骤列出迭代过的实体。

**详情标签页**

详情标签页为每个步骤提供更深入的诊断信息：

* **执行日志** - 运行中每个步骤的时间顺序列表，包含时间戳和持续时间，让您可以查看确切的执行顺序。
* **步骤耗时** - 对于 AI 驱动的步骤，侧边栏显示响应时间和状态详情。这有助于您了解时间消耗在哪里，以及某个步骤是否需要调整。

<Tip>
  性能指标按需加载 - 仅在您展开详情标签页中的步骤时才会获取，即使对于包含多个步骤的运行，侧边栏也能保持快速响应。
</Tip>

### 排查步骤错误

当步骤失败时，Trellis 直接在画布上显示错误详情。每个失败的步骤有两个操作可帮助您快速解决问题：

* **请求 AI 修复** - Trellis 分析错误，用通俗语言解释问题所在，并建议修复方案。很多情况下可以自动应用修正，无需深入研究细节即可重新运行自动化。
* **报告问题** - 如果错误看起来像 bug 或您无法自行解决，点击打开预填了错误详情的反馈对话框作为 bug 报告。直接提交给 Trellis 支持团队 - 无需手动复制错误消息或描述问题。

<Tip>
  先试**请求 AI 修复** - 它能立即解决大多数配置问题，如缺少的字段引用或不正确的条件。当错误超出您的控制范围或修复后仍反复出现时，使用**报告问题**。
</Tip>

### 运行失败通知

当自动化运行失败时，Trellis 自动通知所有工作区成员，让团队能够快速响应。失败通知出现在顶部导航栏的**通知铃铛**中。

点击失败通知可直接跳转到失败运行的详情视图，查看具体哪个步骤失败并使用上述排查工具。

<Info>
  失败通知发送给所有工作区成员。您无需配置任何内容 - 每个自动化都自动启用。
</Info>

***

## 取消正在运行的自动化

如果自动化正在运行而您需要停止它 - 例如误触发或条件已变 - 可以直接从运行详情视图取消。点击运行头部的**取消**按钮。会出现确认对话框确保您确实要停止运行。取消后，运行标记为已取消状态，不再执行后续步骤。

***

## 批量管理自动化

从列表中选择多个自动化，一步启用、禁用或删除它们。适用于按季节暂停所有自动化、清理旧工作流或快速激活新房产组的一组自动化。

***

## 创建优秀自动化的技巧

<CardGroup cols={2}>
  <Card title="从模板开始" icon="rocket">
    模板经过实战验证，覆盖最常见的工作流。根据您的运营定制，而非从零开始构建。
  </Card>

  <Card title="高风险操作使用审批步骤" icon="shield-check">
    涉及退款、政策变更或财务数据的消息应始终有人工审核步骤。
  </Card>

  <Card title="叠加条件提高精准度" icon="filter">
    条件越具体，自动化越智能。仅对已确认入住触发的退房清洁自动化可避免为取消创建不必要的任务。
  </Card>

  <Card title="定期查看自动化日志" icon="clock-rotate-left">
    检查运行历史确保自动化按预期工作。留意跳过的运行或需要处理的错误。
  </Card>

  <Card title="使用模拟运行安全测试" icon="flask">
    激活前在测试模式下运行自动化。模拟运行以烧瓶图标清楚标记，可与实际执行区分。
  </Card>

  <Card title="使用筛选器快速定位问题" icon="magnifying-glass">
    使用运行标签中的状态、日期和触发器类型筛选器快速缩小到失败或意外的运行。
  </Card>
</CardGroup>