AI Agents

DealDome runs on a team of three AI agents that handle everything from Shopify store management to answering course-related questions. You can talk to them through Telegram or hit the API directly — whatever works best for your workflow.

Meet the team

The agent system consists of three specialists, each with their own area of expertise:

  • Alfred — The head agent. Receives every message and decides who should handle it. Think of him as the team lead.
  • Roos — The Shopify agent. Manages orders, products, customers, discount codes, and everything store-related.
  • Elisa — The knowledge agent. Answers questions about course content, video transcripts, and documents.

All three agents are available via Telegram and the REST API.


How routing works

You never have to worry about picking the right agent — Alfred takes care of that for you. Here's how it works under the hood:

  1. You send a message in Telegram (or via the API).
  2. Alfred receives it along with the conversation history for context.
  3. Alfred decides whether he can answer it himself or if it should go to Roos or Elisa.
  4. The sub-agent processes the request using its specialized tools and data sources.
  5. Alfred reformulates the answer and sends it back, casually referring to his colleague — something like "According to Roos, you had 14 orders yesterday."

This means you always talk to one bot, but the entire team is working behind the scenes.


POST/query

API access

For programmatic access, use the POST /query endpoint. Send a message just like you would in Telegram, and the same routing logic applies — Alfred receives the message and delegates to the right agent if needed.

Required attributes

  • Name
    message
    Type
    string
    Description

    The message or question you want to send to the agent system.

Request

POST
/query
curl -X POST https://api.dealdome.eu/query \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"message": "What were our sales yesterday?"}'

Response

{
  "response": "According to Roos, you did €2,340 in sales yesterday across 14 orders. Your best-selling product was the Pro Bundle with 6 units sold.",
  "agent": "alfred",
  "delegated_to": "roos"
}

What's next?

Dive into the details of each agent to see what they can do and which tools they have at their disposal:

Was this page helpful?