Deploy as Alexa Skill
Your agent, now voice-enabled. Connect it to Alexa and let users talk to it like a human.
INFO
Why Deploy Your Agent to Alexa?
Voice extends your agent’s reach. Alexa integration lets users interact naturally with no screens or keyboards required. It’s ideal for:
- Personal assistants
- FAQ bots
- Home automation agents
- Productivity helpers
All it takes is one endpoint and a little setup.
Prerequisites
Make sure you have the following ready:
- A deployed SmythOS agent (must be public; no authentication)
- An Amazon Developer account (sign up here)
- Basic agent behavior already configured
Step 1: Get Your SmythOS Alexa Endpoint URL
- Go to your SmythOS Dashboard
- Select your deployed agent
- Open the Test sidebar and click the Alexa tab
- Copy the provided endpoint... it looks like this:
https://<your-agent>.agent.stage.smyth.ai/alexa
INFO
Step 2: Create a New Alexa Skill in the Developer Console
- Visit the Alexa Developer Console
- Click Create Skill
- Enter a name (e.g. "My SmythOS Agent")
- Choose Custom for the model
- Select Start from scratch
- Click Create Skill
Step 3: Add Your SmythOS Endpoint as the Skill Handler
- In the left sidebar, go to Endpoint
- Set Service Endpoint Type to
HTTPS
- Paste your SmythOS Alexa URL in Default Region
- Under Certificate Type, select:
My development endpoint is a sub-domain...
- Save changes
Step 4: Choose an Invocation Name for Your Skill
- In the sidebar, go to Invocation
- Enter how users will launch your agent (e.g., "my agent")
- Save the model
Step 5: Add a Custom Intent for User Queries
- Navigate to Intents → click Add Intent
- Name it
SmythOSAgentIntent
- Create a custom intent
- Add the following sample utterances:
{searchQuery}
ask {searchQuery}
tell me {searchQuery}
find {searchQuery}
search for {searchQuery}
- When prompted, create the
searchQuery
slot - Set its type to
AMAZON.SearchQuery
Step 6: Build and Test Your Alexa Skill
- Click Build Model (wait for it to finish)
- Open the Test tab
- Enable testing in
Development
mode - Try your invocation:
Alexa, open my agent
Alexa, ask what’s the weather in New York
How Your Alexa-Connected Agent Works Behind the Scenes
- The invocation triggers your agent via the Alexa endpoint
- Alexa sends the query using the
searchQuery
slot - SmythOS handles it and returns a response
- Alexa reads the agent’s reply aloud
Known Limitations and Constraints
- Only public agents without authentication are supported
- Alexa limits the character count in responses
- Visuals and complex UI are not supported
- Users must re-invoke your skill after each interaction
Optional: Publish Your Alexa Skill to the Public
Want to go public?
- Open the Distribution tab in the Alexa console, part of the Alexa Skills Kit (ASK) developer console
- Fill in:
- Skill description
- Sample phrases
- Icons (108x108 and 512x512)
- Privacy and terms URLs
- Submit for certification
Connect your public SmythOS agent to Alexa by using the HTTPS endpoint and defining a searchQuery intent.
What’s Next?
Now that your voice interface is live:
- Track usage inside SmythOS Agent Settings → Logs
- Iterate on your agent logic, then rebuild the Alexa model
- Explore alternate voice use cases with MCP or ChatBot deployments
Your agent just got its voice. What you do with it is up to you.