云端部署

概述

tracio.ai 是一个完全托管的云平台。你的应用从浏览器发送信号，云端返回识别结果。平台负责处理扩缩容、冗余和基础设施管理。

上手只需几分钟：创建账户、获取公钥、安装 SDK，然后开始识别访客。

工作原理

你的应用通过客户端 JavaScript SDK 与云端通信。SDK 会在浏览器中加载一个 agent，采集信号，并返回识别结果：

Browser (JS SDK)  ──▶  tracio.ai Cloud
                  ◀──  (identification result)

1. 浏览器 SDK 加载 agent 并采集信号。
2. 信号被发送到 tracio.ai 云端。
3. 云端返回结果：visitorId 和 bot 信息。

若要在自己的服务器上对结果做出响应，可将每次识别作为经过签名的 webhook 接收。

快速开始

1. 注册并打开你的控制台。
2. 选择你的数据区域（见下文）。
3. 复制你的公钥——它可以安全地随客户端代码一起发布。
4. 安装 SDK 并初始化：

import { Tracio } from "@tracio/sdk"

const tracio = Tracio.init({
  publicKey: "5ca175fc...",
  region: "eu",
})

数据区域

SDK 的 region 选项用于选择 SDK 与哪个数据区域通信。它接受 "us" 或 "eu"。若未设置，SDK 会使用通用的 https://edge.tracio.ai 端点——显式设置该选项即可固定到某个区域。

API 密钥管理

• 你的公钥用于浏览器，可以安全地在客户端代码中公开。
• 通过你的控制台管理和轮换密钥。
• 若要在服务器端使用结果，请配置 webhook——每次识别都会投递到你的端点，并使用 X-Tracio-Signature 签名。

Webhooks

你可以配置 webhook，以接收来自云端的通知。有关配置与 payload 详情，请参阅 Webhooks。