Echo AI

将您的智能体（agent）连接至 Echo AI —— 一个供企业和创作者构建 AI 驱动助手（称为 Echos）的平台，适用于销售、客户支持与用户互动等场景。

通过此技能，您的智能体可发现可用的 Echos、读取其知识库，并与之开展对话。

快速开始

1. 前往 echoai.so 注册（提供免费套餐）
2. 创建您的首个 Echo，或浏览现有 Echo
3. 进入 Settings → API Keys，生成一个 API 密钥
4. 将环境变量 ECHO_API_KEY 设置为该密钥值

此技能支持的功能

1. 列出可用的 Echos（免费，不消耗积分）

查询当前 API 密钥下可访问的 AI 助手列表。

GET https://auth.echoai.so/functions/v1/api/assistants
Header: X-API-Key: $ECHO_API_KEY

响应示例：

{
  "assistants": [
    {
      "id": "uuid",
      "name": "Sales Assistant",
      "bio": "I help qualify leads and answer product questions",
      "slug": "sales-assistant",
      "avatar_url": "https://...",
      "tone": "professional",
      "style": "concise",
      "topics": ["pricing", "features", "onboarding"]
    }
  ]
}

2. 获取 Echo 详情及知识库（免费，不消耗积分）

获取 Echo 的完整档案，包括常见问题（FAQs）、推荐提问、人格设定等信息。

GET https://auth.echoai.so/functions/v1/api/assistant/{id}
Header: X-API-Key: $ECHO_API_KEY

响应内容包含：名称、简介、FAQs、预设问题、主题领域、语气（tone）、风格（style）和背景设定（lore）。

若用户的问题可在 FAQs 中直接找到答案，请直接作答 —— 无需发起聊天请求。

3. 与 Echo 聊天（消耗积分）

向 Echo 的 AI 发送消息并接收回复。

POST https://auth.echoai.so/functions/v1/api/chat
Header: X-API-Key: $ECHO_API_KEY
Content-Type: application/json

请求示例：

{
  "message": "What pricing plans do you offer?",
  "assistant_id": "the-echo-uuid",
  "session_id": "optional — pass from previous response for continuity",
  "visitor_id": "optional — your identifier for this conversation"
}

响应示例：

{
  "response": "We offer three plans: Starter at $29/mo, Pro at $79/mo...",
  "session_id": "use-this-in-next-message",
  "visitor_id": "your-visitor-identity",
  "assistant_id": "the-echo-uuid"
}

务必在后续消息中传入上一次响应中的 session_id，以维持对话上下文。

工作流程

当被要求查找或列出 Echos 时：

1. 调用 GET /api/assistants
2. 向用户展示结果，包括名称、简介与主题领域
3. 询问用户是否需要了解某个特定 Echo 的详细信息

当被问及某个具体 Echo 时：

1. 调用 GET /api/assistant/{id}
2. 向用户展示该 Echo 的档案、FAQs 及推荐提问
3. 若问题可在 FAQs 中直接解答，则立即作答（零成本）

当用户希望与某个 Echo 聊天时：

1. 向用户发出提示：“这将向 Echo 发送消息，并消耗 Echo 所有者的积分。是否继续？”
2. 若用户确认，则调用 POST /api/chat
3. 返回响应内容，并保存 session_id 用于后续交互

错误处理

重要规则

• 切勿在未经用户明确确认的情况下发起聊天请求 —— 此类调用将消耗 Echo 所有者的积分
• 始终优先使用 FAQs 和 Echo 档案信息来回答问题（零成本）
• 必须始终在后续消息中传递 session_id，以维持对话上下文
• 速率限制按 API 密钥单独配置（默认：每分钟 60 次请求）

关于 Echo AI

Echo 是一个面向所有人的平台，用户可为其业务创建 AI 驱动的助手（Echos）。Echos 可部署于网站、WhatsApp、Instagram、Telegram、Discord、Slack 等多种渠道，用于处理销售对话、客户服务、潜在客户筛选以及预约安排等任务。

了解更多：echoai.so