Activepieces 集成

在 Activepieces 流程中使用您的 Asyntai 助手

获取 API 密钥

需要付费套餐： Activepieces 集成适用于 Starter、Standard 和 Pro 套餐。查看定价

概述

Activepieces 是一款开源自动化工具。Asyntai 组件把客户消息发给您的助手并返回答复。之后您可以把这条答复送到流程中的任何地方：邮件回复、Slack 消息、工单系统或数据库行。

可用操作

Asyntai 组件提供两个操作：

询问助手 - 把客户消息发给一个助手并返回答复
自定义 API 调用 - 用同一个连接调用任意 Asyntai API 端点

注意： 组件从 npm 安装。您需要自建的 Activepieces 实例，或 Activepieces Cloud 的平台管理员权限。

如何安装

按以下步骤把 Asyntai 连接到 Activepieces：

获取您的 API Key

打开 API 设置页面并生成密钥：

https://asyntai.com/settings/api/

复制密钥并妥善保管。任何人拿到密钥都能通过 API 访问您的 Asyntai 账户。

安装 Asyntai 组件

在 Activepieces 中依次打开 Settings、My Pieces、Install Piece。输入这个包名：

@asyntai/piece-asyntai

连接您的账户

在流程中添加一个 Asyntai 步骤。新建连接并粘贴您的 API 密钥。Activepieces 会立即校验密钥，若不正确会提示错误。

搭建流程

一个流程包含两部分：

触发器：任意 Activepieces 触发器，例如新邮件、表单提交或 Webhook
操作：Asyntai - 询问助手

把客户消息和一个固定的会话 ID 从触发器传给 Asyntai 操作。

把答复送回去

再加一个步骤来送达答复：Gmail、Slack、工单系统或短信服务。用 Asyntai 步骤的 answer 字段作为回复正文。

测试并发布

用真实的客户问题做一次测试。确认答复后发布流程。

询问助手的输入项

Assistant Website（必填）- 负责回答的助手。列表从您的账户加载。
Customer Message（必填）- 助手需要回答的文本。
Conversation ID（必填）- 该客户或会话的固定值，例如邮箱地址或工单号。
Source Channel（必填）- 消息来自哪里。邮件渠道会给助手加上邮件相关的指示。

询问助手的输出项

answer - 助手的答复。
conversation_id - 答复所属的会话。
ai_disclosure - 人工智能告知文本。请展示给客户。
success - 调用是否成功。

提示： 在Asyntai 控制台中添加指示、常见问题和知识库内容，可以让答复更好。

对话历史

Asyntai 按您发送的会话 ID 保存历史。同一位客户用同一个值，助手就会记得之前的消息。换一个新值即开始新会话。

每次调用都会在历史中增加一条消息，因此重复运行会产生重复记录。设置重试时请注意这一点。

示例用例

邮件支持：新邮件到达后助手起草答复，由 Gmail 发送
Slack 工单：Slack 频道中的提问在同一条会话中得到答复
表单回复：联系表单提交后几秒内触发邮件答复
工单分流：助手回答简单工单，其余交给人工
短信答复：接入短信服务，在客户手机上回复

源代码

该组件是 MIT 许可的开源软件。npm 上的包名是：