# 自动操作

## 什么是自动操作？

"**Automation**" is a feature which can automate task for AAPS.

Automations performs specific actions based on one or more conditions or triggers. Triggers can include irregular events like low or high blood glucose (BG) levels, or a set amount of negative insulin on board (IOB). Automations can also handle recurring events, such as meals or exercise at certain times of day, or when the user is within a specific distance of a GPS location or a WIFI SSID area. Automation can execute AAPS settings backups based on a schedule or on every Pod change.

Automations rules are created and modified from the Automations tab. Each rule is defined by two properties:

- One or more conditions or 'triggers' that start an action.

    Think of a certain time schedule, an event or properties value in AAPS

- One or more actions to perform.

    Such as an alarm or settings a profile percentage or exporting the AAPS settings on Pod change.


There are a wide range of Automation options, and users are encouraged to study these within the AAPS app, in the Automation section. You can also search the AAPS user groups on ![**Facebook**](https://www.facebook.com/groups/AndroidAPSUsers) and ![**Discord**](https://discord.gg/4fQUWHZ4Mw) for Automation examples from other users.

## 自动操作如何帮助我们

1. **Automate reoccurring tasks:** Automatically executing programmed actions without user interaction.

1. **减少决策疲劳**：**自动操作**的主要好处是减轻用户需要手动干预**AAPS**的负担。 研究估计，患有1型糖尿病的人平均每天需要做出额外的180个决策。 **自动化**可以减轻心理负担，让用户能够将精力投入到生活的其他方面。

1. **可能改善血糖控制**：例如，**自动操作**可以确保在需要时始终设置**临时目标**，即使在忙碌或健忘的情况下也是如此。 例如，如果一个患有糖尿病的孩子在学校每周二上午10点和周四下午2点有体育活动，并且需要在活动前30分钟设置高血糖临时目标（TT），那么可以通过自动操作来实现。

1. **使AAPS高度可定制**：根据用户的偏好，在特定情况下可以更加或不太激进。 例如，如果在半夜出现负**IOB**，表明当前**配置文件**可能过强，可以触发一段时间内的临时降低**配置文件**百分比。

下面的例子说明了如何通过**自动化**来省略某些步骤。

用户每天早上6点锻炼：他需要在锻炼前，即早上5点，手动在AAPS中设置“TT-活动”。

![Alt text](../images/automation_2024-02-12_20-54-50.png)

用户设置了一个**自动操作**，在早上5点触发“TT-活动”，以确保他们的**血糖**和**IOB**在准备6点锻炼时处于最佳状态：

![Alt text](../images/automation_2024-02-12_20-54-49.png)

## 开始使用自动操作前的关键考虑

1. Before setting up certain Automations, you should have reasonable **BG** control with **AAPS**. Automations should not be used to compensate for sub-optimal basal, **ISF** or **CR** settings (discussed further below). 避免设置自动化**配置文件切换**来补偿由于食物等原因导致的**血糖**升高，这些情况最好通过其他策略（如SMBs等）来处理。

1. 与所有技术一样，**持续葡萄糖监测系统（CGMs）**、**胰岛素泵**和手机都有可能出现故障：技术问题或传感器错误可能会中断**自动化操作**，这时可能需要进行手动干预。

1. 随着日常活动的变化，**自动操作的需求**也可能发生变化。 在工作/学校/假期之间切换时，请在日历中设置提醒，以审查当前活跃的**自动操作**（它们很容易激活和停用）。 例如，如果你去度假，不再需要为学校体育或日常锻炼设置的自动操作，或者需要调整时间。

1. **自动操作**可能会相互冲突，因此最好在安全环境中仔细审查任何新的**自动操作**设置，并了解为什么**自动操作**可能未按预期触发。

1. 如果使用Autosens功能，请尽量使用**临时目标（Temp Targets）**而不是**配置切换（Profile Switches）**。 **临时目标**不会将Autosens重置为0， 而配置切换会重置Autosens。

1. 大多数**自动操作**应仅设置**有限的时间段**，之后**AAPS**可以重新评估并根据需要重复自动操作（如果条件仍然满足）。 例如，“启动7.0 mmol/l的临时目标持续30分钟”或“启动110%的**配置文件**持续10分钟”_以及_“启动5.0 mmol/l的临时目标持续10分钟”。 使用**自动操作**创建永久更改（例如，更改为更强的配置文件百分比）可能会导致低血糖。

## 我什么时候可以开始使用自动操作？

可以在**目标10**中开始使用**自动操作**。

## 自动操作在AAPS中的位置

Depending on your [Config builder > General](../SettingUpAaps/ConfigBuilder.md) settings, **Automation** is located either in the ‘hamburger’ menu or as a tab with **AAPS**.

## 如何设置自动操作？

要设置**自动操作**，请在**AAPS**中创建一个“规则”如下：

![创建自动操作](../images/automation_create.png)

* 为你的“规则”命名；
* 选择至少一个“条件”；

![自动操作条件](../images/automation_condition.png)

* 选择一个“操作”；

![自动操作](../images/automation_action.png)

* 勾选**自动化**事件右侧的方框以激活**自动化**：

![自动操作](../images/automation_2024-10-26_17-48-05.png)



要停用**自动操作**规则，请取消勾选规则名称左侧的框。 下面的示例显示了一个名为“低血糖TT”的**自动操作**，它可以被激活（勾选）或停用（未勾选）。

![Alt text](../images/automation_2024-02-12_20-56-08.png)


在设置**自动化**时，您可以首先通过激活“操作”下的“通知”选项来测试它。 这会触发**AAPS**首先显示通知，而不是实际自动化操作。 当您确认通知已在正确的时间/条件下触发后，可以更新**自动化**规则，将“通知”替换为“操作”。

![Alt text](../images/automation_2024-02-12_20-55-05.png)

```{admonition} Important note
:class: note
**自动操作**在闭环禁用时仍然有效！
```


## 安全限制

对**自动操作**设置了安全限制：

* **血糖**值必须在72 mg/dl和270 mg/dl（或4 mmol/l和15 mmol/l）之间。
* “**配置文件百分比**”必须在70%到130%之间。
* **自动操作**执行（及首次执行）之间有5分钟的时间限制。

## 正确使用负值

```{admonition} Warning
:class: warning
在选择**自动操作**中的负值时请小心。
```

在选择“条件”中的负值（如“小于”）时需要谨慎。 For example:

![Alt text](../images/automation_2024-02-12_20-56-25.png-500x.png)

**示例1**：创建条件**“小于”**-0.1 mmol/l（或-2 mg/dl）将：

当任何**严格小于**-0.1（-2）的数字时触发**自动操作**。 这包括-0.2、-0.3、-0.4（-4、-6、-8）等数字。 请记住，-0.1（-2）本身**不**包括在此条件中。 （条件“等于或小于”-0.1 mmol/l或-2 mg/dl_将_包括-0.1 mmol/l或-2 mg/dl）。

**示例2**：创建条件“大于”-0.1 mmol/l（-2 mg/dl）将：

当任何**大于**-0.1 mmol/l（-2 mg/dl）的数字时触发**自动操作**。 这包括0、0.2、0.4 mmol/l（0、4、8 mg/dl）等任何正数。

在选择这些条件和值时，必须仔细考虑**自动操作**的确切意图。

(automations-automation-triggers)=
## Automation Triggers

![Automation Triggers](../images/automation_triggers.png)

There are various ‘Triggers’ that can be selected by the user. Triggers are the conditions that must be met in order for the automation to execute. 以下列表并不详尽：

**Trigger:** connect conditions

**选项：**

可以使用多个条件链接
* “和”
* “或”
* “异或”（即如果仅当且仅当一个条件适用时，才会执行操作）

**Trigger:** time vs. recurring time

**选项：**

* 时间 = 单次事件时间
* 循环时间 = 循环发生的事件（例如，每周一次，每个工作日等）

**Trigger:** location

**选项：**

* 在**配置构建器**（自动化）中，用户可以选择所需的位置服务。

**Trigger:** location service

**选项：**

* 使用被动位置：**AAPS**仅在其他应用请求位置时获取位置。
* 使用网络位置：你的Wi-Fi位置。
* 使用GPS位置（注意！ 这可能会导致电池过度消耗！）

**Triggers** : pump and sensor data

* Cannula age trigger: Available for all pumps
* Insulin age trigger: Available for supported pumps
* Battery age trigger: Available for supported pumps
* Sensor age trigger: always available
* Pod Activation trigger: Available for patch pumps

Note that for all age related triggers the equal comparison is unlikely to trigger, so in that case two triggers are required to create a range

* Reservoir level trigger: Available for all pumps, comparison "NOT\_AVAILABLE" is not working for this trigger as the value is always filled in **AAPS**
* Pump battery level trigger: Available for supported pumps, comparison "NOT\_AVAILABLE" is not working for this trigger as the value is always filled in **AAPS**

## 操作

![Automation Triggers](../images/automation_actions.png)

**操作**：启动**临时目标**

**选项：**

* **血糖**必须在72 mg/dl和270 mg/dl（4 mmol/l和15 mmol/l）之间
* **临时目标（TT）**仅在之前没有临时目标时有效

**操作**：停用**临时目标**

**选项：**

无

**操作**：**配置文件百分比（Profile Percentage）**

**选项：**

* **配置文件**必须在70%和130%之间
* 仅当之前的百分比为100%时才有效

添加“操作”后，必须点击并调整默认值以更改为所需的数字。

![Alt text](../images/automation_2024-02-12_20-57-07.png)

(Automations-the-order-of-the-automations-in-the-list-matters)=
## **自动操作**列表中的顺序很重要
 **AAPS**将按照偏好顺序自动执行创建的规则，从**自动操作**列表的顶部开始。 例如，如果“低血糖”**自动操作**是所有规则中最重要的，那么它应该出现在用户**自动操作**列表的顶部，如下所示：


![Alt text](../images/automation_2024-02-12_20-57-48.png-500x.png)

要重新排列**自动化**规则的优先级，请点击并按住屏幕右侧的四个线条按钮。 通过上下移动规则来重新排列**自动化**的顺序。

![Alt text](../images/automation_2024-02-12_20-58-00.png-500x.png)

## 如何删除自动操作规则

要删除一个**自动化**规则，请点击垃圾桶图标。

![Alt text](../images/automation_2024-02-12_20-58-26.png-500x.png)

# 自动操作示例

以下是**自动操作**的示例。 关于**自动操作**以及用户如何个性化**自动操作**的进一步讨论，可以在Facebook讨论组或Discord上找到。 下面的示例不应在用户未充分理解**自动操作**将如何工作的情况下复制。

### 低血糖临时目标

这个**自动化**功能在血糖（**BG**）低于某个阈值时会自动触发“临时目标-低血糖”。

![Alt text](../images/automation_2024-02-12_21-04-01.png-500x.png)

### 午餐时间临时目标（带“位置”）

![Alt text](../images/automation_2024-02-12_21-04-25.png-500x.png)

此**自动操作**为在工作日中午左右吃午餐的用户创建，但仅在用户位于设定“位置”时才触发。  因此，如果用户有一天不在工作，此**自动操作**将不会激活。

此**自动操作**将在13:00设置低**临时目标-即将用餐**以将血糖驱动至90 mg/dl（或5 mmol/l）为午餐做准备。

“触发”位置通过设置纬度和经度GPS坐标来设置，如下所示：

![Alt text](../images/automation_2024-02-12_21-04-40.png-500x.png)

由于“和”连接，**自动操作**仅在“选定时间”且用户在选定位置时才发生。

**自动操作**不会在其他时间在此位置或在此时间之外50米设定的GPS坐标内触发。

### WIFI SSID位置自动操作

使用WIFI SSID是触发**自动操作**的好方法，当用户在特定wifi网络范围内时（与GPS相比），它相当精确，使用电池较少，并且在GPS和其他位置服务可能无法使用的封闭空间内也能工作。

下面是另一个示例，设置工作日前早餐前的**临时目标**（1）。


**自动操作**将在周一至周五的05:30am触发（2）  
并且当用户连接到家庭wifi网络时（3）。


然后，它将设置30分钟的75 mg/dl**临时目标**（4）。 包含位置的一个优点是，如果用户在度假旅行，它将不会触发。

![Alt text](../images/automation_2024-02-12_21-05-02.png-500x.png)

以下是详细**自动操作**触发器的截图：

1)在主要的“并且”（两个条件都需要满足才能触发）条件下： 1)重复时间为周一、周二、周三、周四、周五的早上5:30  
1)WIFI名称（SSID）为“My_Home_WiFi_Name”

![Alt text](../images/automation_2024-02-12_21-05-16.png-500x.png)

# Automating Preference Settings Export

### Unattended Exports: scheduled (daily)

Screenshots detailing the Automation triggers:

1) Condition: Recurring time = M,T,W,T,F At 8:00am 1) Action: Settings Export (For "Text in treatments" enter "Daily")

![Scheduled exports](../images/Automations/automation_settingsexport_scheduled_400px.png)

Note: Export execution will be logged on Careportal

### Unattended Exports: Pod Activation (patch pump only)

Screenshots detailing the Automation triggers:

1) Condition: Pod Activation 1) Action: Settings Export (For "Text in treatments" enter "Pod Activation: settings export")

![Export on Pod activation](../images/Automations/automation_settingsexport_podactivation_400px.png)

Note: Export execution will be logged on Careportal. Note : Automation will not trigger **at all** if you have not done a manual settings export before. See [Preferences > Maintenance](#preferences-maintenance-settings) for proper activation of unattended settings export.


# 自动操作日志

**AAPS**在**自动操作**选项卡底部的屏幕上记录了最近触发的**自动操作**日志。

在下面的示例中，日志显示：

(1) 在01:58 am，“低血糖触发临时低血糖配置文件”被激活
* 血糖值小于75 mg/dl；
* 增量为负（即：血糖正在下降）；
* 时间在01:00 am和06:00 am之间。

**自动化**将会：
* 设置40分钟的110 mg/dl**临时目标**；
* 启动40分钟的50%临时**配置文件**。

(2) 在03:38 am，“夜间低血糖后高碳水”被触发
* 时间在01:05 am和06:00 am之间；
* 血糖值大于110 mg/dl。

**自动化**将会：
* 更改**配置文件**为LocalProfile1（即：取消任何临时配置文件）
* 停止**临时目标**（如果有的话）。

![Alt text](../images/automation_2024-02-12_21-05-56.png-500x.png)

## Troubleshooting

* 问题：__我的自动化没有由AAPS触发？__

勾选右侧的框以激活自动操作事件：

## Troubleshooting

![Alt text](../images/automation_2024-02-12_21-06-12.png-500x.png)

* 问题：__我的自动化触发顺序不正确。__

检查如上所述的规则优先级顺序。

## 自动操作的替代方案

对于高级用户，还有其他方法可以使用IFTTT或第三方Android应用（如Automate）来自动化任务。