Echo AI
Connect your agent to Echo AI — a platform where businesses and creators build AI-powered assistants (called Echos) for sales, support, and customer engagement.
With this skill, your agent can discover Echos, read their knowledge bases, and have conversations with them.
Get started
- 1. Sign up at echoai.so (free tier available)
- Create your first Echo or browse existing ones
- Go to Settings → API Keys and generate a key
- Set the environment variable
ECHO_API_KEY to your key
What this skill can do
1. List available Echos (free, no credits)
Discover which AI assistants are available under your API key.
CODEBLOCK0
Response:
CODEBLOCK1
2. Get Echo details and knowledge base (free, no credits)
Retrieve an Echo's full profile including FAQs, suggested questions, and personality.
CODEBLOCK2
Response includes: name, bio, FAQs, preset questions, topics, tone, style, and lore.
If the user's question can be answered from FAQs, answer directly — no chat call needed.
3. Chat with an Echo (costs credits)
Send a message and get a response from the Echo's AI.
CODEBLOCK3
Request:
CODEBLOCK4
Response:
CODEBLOCK5
Always pass session_id from the response into the next message to maintain conversation context.
Workflow
When asked to find or list Echos:
- 1. Call INLINECODE2
- Present the results with name, bio, and topics
- Ask if the user wants details on a specific one
When asked about a specific Echo:
- 1. Call INLINECODE3
- Present the Echo's profile, FAQs, and suggested questions
- If the question can be answered from FAQs, answer directly (zero cost)
When the user wants to chat with an Echo:
- 1. Warn the user: "This will send a message to the Echo and consume the Echo owner's credits. Proceed?"
- If confirmed, call INLINECODE4
- Return the response and save the
session_id for follow-ups
Error handling
| Status | Meaning | Action |
|---|
| 401 | API key missing or invalid | Check ECHO_API_KEY is set correctly |
| 402 |
Echo owner out of credits | Inform the user, cannot proceed |
| 403 | Key doesn't have access to this Echo | Use correct key or request access |
| 429 | Rate limit exceeded | Wait and retry (default: 60 req/min) |
| 404 | Echo or endpoint not found | Verify the Echo ID or endpoint path |
Important rules
- - Never make chat calls without explicit user confirmation — they cost the Echo owner credits
- Always prefer FAQs and Echo info to answer questions when possible (zero cost)
- Always pass
session_id back in follow-up messages to maintain context - Rate limits are configurable per API key (default: 60 requests/minute)
About Echo AI
Echo is a platform where anyone can create AI-powered assistants for their business. Echos can be deployed on websites, WhatsApp, Instagram, Telegram, Discord, Slack, and more. They handle sales conversations, customer support, lead qualification, and appointment booking.
Learn more: echoai.so
Echo AI
将您的智能体连接到Echo AI——这是一个企业和创作者构建AI驱动助手（称为Echo）的平台，用于销售、支持和客户互动。
通过此技能，您的智能体可以发现Echo、读取其知识库，并与它们进行对话。
开始使用
- 1. 在echoai.so注册（提供免费套餐）
- 创建您的第一个Echo或浏览现有Echo
- 前往设置 → API密钥并生成一个密钥
- 将环境变量ECHOAPI_KEY设置为您的密钥
此技能的功能
1. 列出可用Echo（免费，不消耗积分）
发现您的API密钥下有哪些AI助手可用。
GET https://auth.echoai.so/functions/v1/api/assistants
请求头: X-API-Key: $ECHOAPIKEY
响应：
json
{
assistants: [
{
id: uuid,
name: 销售助手,
bio: 我帮助筛选潜在客户并回答产品问题,
slug: sales-assistant,
avatar_url: https://...,
tone: 专业,
style: 简洁,
topics: [定价, 功能, 入门指南]
}
]
}
2. 获取Echo详情和知识库（免费，不消耗积分）
检索Echo的完整资料，包括常见问题、建议问题和个性特征。
GET https://auth.echoai.so/functions/v1/api/assistant/{id}
请求头: X-API-Key: $ECHOAPIKEY
响应包括：名称、简介、常见问题、预设问题、主题、语气、风格和背景故事。
如果用户的问题可以从常见问题中找到答案，直接回答——无需调用聊天功能。
3. 与Echo聊天（消耗积分）
发送消息并从Echo的AI获取回复。
POST https://auth.echoai.so/functions/v1/api/chat
请求头: X-API-Key: $ECHOAPIKEY
Content-Type: application/json
请求：
json
{
message: 你们提供哪些定价方案？,
assistant_id: the-echo-uuid,
session_id: 可选——从之前的响应中传递以保持连续性,
visitor_id: 可选——您对此对话的标识符
}
响应：
json
{
response: 我们提供三种方案：入门版每月29美元，专业版每月79美元...,
session_id: 在下一条消息中使用此ID,
visitor_id: 您的访客身份标识,
assistant_id: the-echo-uuid
}
始终将响应中的session_id传递给下一条消息，以保持对话上下文。
工作流程
当被要求查找或列出Echo时：
- 1. 调用GET /api/assistants
- 展示结果，包括名称、简介和主题
- 询问用户是否需要某个特定Echo的详细信息
当被问及特定Echo时：
- 1. 调用GET /api/assistant/{id}
- 展示Echo的资料、常见问题和建议问题
- 如果问题可以从常见问题中找到答案，直接回答（零成本）
当用户想要与Echo聊天时：
- 1. 警告用户：这将向Echo发送一条消息并消耗Echo所有者的积分。是否继续？
- 如果确认，调用POST /api/chat
- 返回响应并保存session_id以便后续跟进
错误处理
| 状态码 | 含义 | 操作 |
|---|
| 401 | API密钥缺失或无效 | 检查ECHOAPIKEY是否正确设置 |
| 402 |
Echo所有者积分不足 | 告知用户，无法继续 |
| 403 | 密钥无权访问此Echo | 使用正确的密钥或请求访问权限 |
| 429 | 超出速率限制 | 等待后重试（默认：60次请求/分钟） |
| 404 | 未找到Echo或端点 | 验证Echo ID或端点路径 |
重要规则
- - 切勿在未经用户明确确认的情况下进行聊天调用——这会消耗Echo所有者的积分
- 始终优先使用常见问题和Echo信息来回答问题（零成本）
- 始终在后续消息中传递session_id以保持上下文
- 速率限制可按API密钥配置（默认：60次请求/分钟）
关于Echo AI
Echo是一个平台，任何人都可以为其业务创建AI驱动的助手。Echo可以部署在网站、WhatsApp、Instagram、Telegram、Discord、Slack等平台上。它们处理销售对话、客户支持、潜在客户筛选和预约预订。
了解更多：echoai.so
