通过一次 API 调用将 AI 聊天添加到您的应用程序

TL;DR： aiSTAFF 公共 Bot API 为开发人员提供了与在 REST 调用中提供社交渠道相同的聊天引擎。您发送消息和用户 ID，获得 AI 响应，然后服务器会为您处理对话状态、历史记录和上下文。

为什么是 API 而不是另一个小部件

网站小部件和社交渠道覆盖了大多数企业。构建产品的开发人员还需要其他东西：软件访问。 aiSTAFF Bot API 公开了 aiSTAFF 平台背后的引擎，因此您可以在自己的应用程序、门户或内部工具中部署 AI 聊天。我们的自动化服务帮助其构建定制。

问题是，您不需要构建。没有敏捷工程，没有对话状态，没有上下文窗口杂耍，没有模型提供程序配置，没有令牌限制管理。您调用端点并返回响应。

API 公开的内容

表面故意变小：

机器人。创建和管理 AI 机器人，每个机器人都有自己的业务描述、知识库、语气、语言以及问候语或备份消息。
聊天。发送消息并以单个 JSON 响应或流的形式接收响应。传递用户 ID，服务器将更新与该用户的对话，或者传递消息 ID 以使其显而易见。
对话。创建、列出、获取历史记录或删除。服务器会为您保存和清除消息历史记录。
使用情况。阅读有关使用情况（针对您的限制、消耗的代币以及当前时间段）的通知。
密钥。生成并旋转显示一次并丢弃的 API 密钥。

服务器正在保留对话

聊天功能最棘手的部分是内存。简单的集成必须存储每条消息，决定向模型发送多少消息，并在解析之前修复上下文。 aiSTAFF API 会为您完成此操作。随每条消息发送用户 ID，服务器广播对话，并保留最新的历史值。对话内存层中描述了通道使用的相同内存模型。

流式或单一响应

对于聊天界面，逐字流转的响应变得栩栩如生。该 API 支持同一端点（流媒体网站小部件）上的流模式，在您的网站上流式 AI 聊天对此进行了介绍。对于一次需要整个响应的备份作业，单个 JSON 响应更适合。您可以根据每次调用进行选择。

一个配额，一个引擎

API 通知是从与您的社交频道相同的订阅池接收的。 Messenger 没有单独的 API 计量器，保持计费简单，并具有相同的单一配额模型定义跨所有渠道的单一消息配额。根据您的计划调整限制，以便更高的层每分钟收到更多的请求。

谁访问 API

它由三种类型的构建器使用。一家想要向客户提供白标人工智能聊天服务的机构。 SaaS 产品需要有用的应用内助手。一家拥有定制门户的企业希望用同样的大脑在 Instagram 上与客户见面。在每种情况下，API 都被视为同一 AI 大脑的另一个通道，该模型在一个 AI 大脑，五个通道中描述。

密钥和安全

每个请求都使用 API 密钥进行身份验证，该密钥在创建时显示一次，存储为哈希值，如果泄露则失效。您可以不间断地转动钥匙。由于引擎在服务器端运行，因此您的应用程序永远不会有模型提供程序密钥或快速逻辑，从而使您的表面保持较小。如需更全面地了解 aiSTAFF 与其他聊天机器人堆栈的比较，请参阅聊天机器人平台比较。

从哪里开始

创建一个机器人，生成密钥并使用用户 ID 发送您的第一条消息。响应、历史记录和使用情况跟踪返回，无需您进行任何额外的操作。当您想围绕它构建自定义集成时，请从我们的自动化服务开始，并针对业务案例阅读完整的商业聊天机器人指南。

常见问题解答

对话历史记录发生在我身上吗？

没有。将用户 ID 与每条消息一起发送，服务器会保存并清除历史记录，为您更新正确的对话。

API 可以流式传输响应吗？

是的。聊天端点支持实时界面的流模式和单个 JSON 响应支持。

API 是否与我的渠道分开衡量？

没有。 API 消息源自与 Messenger、Instagram、WhatsApp、Telegram 和小部件相同的订阅配额。

请求如何进行身份验证？

API 密钥在创建时显示一次，它会存储为哈希值并且无法撤销。您可以不间断地转动钥匙。