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)
2. Create your first Echo or browse existing ones
3. Go to Settings → API Keys and generate a key
4. 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.

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

Response:

{
  "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. Get Echo details and knowledge base (free, no credits)

Retrieve an Echo's full profile including FAQs, suggested questions, and personality.

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

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.

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

Request:

{
  "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:

{
  "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"
}

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 GET /api/assistants
2. Present the results with name, bio, and topics
3. Ask if the user wants details on a specific one

When asked about a specific Echo:

1. Call GET /api/assistant/{id}
2. Present the Echo's profile, FAQs, and suggested questions
3. If the question can be answered from FAQs, answer directly (zero cost)