Documentation
Everything you need to build, deploy, and analyze with Stetos.co.
Quick Start
Follow these steps to deploy your first listening agent and start gathering insights.
1. Create a Project
Navigate to your dashboard and click "New Project". This acts as a workspace for your agents.
2. Configure Your Agent
Define your agent's goal (e.g., "Feedback on new checkout flow"). Upload any relevant context or knowledge documents to help it answer user questions.
3. Embed the Widget
Copy the generated Javascript snippet and paste it into the <head> of your website.
<script
src="https://stetos.co/widget/v1.js"
data-agent-id="YOUR_AGENT_ID"
></script>Platform Concepts
Agents
An agent is an AI entity configured with a specific persona and goal. It conducts interviews on your behalf. You can have multiple agents per project, each targeting a different user segment or research topic.
Sessions
A session represents a single interaction between a user (interviewee) and your agent. Sessions can be text-based or voice-based. Stetos automatically transcribes voice sessions and stores the full conversation history.
Knowledge Base
You can upload documents (PDF, TXT, MD) to an agent's knowledge base. The agent uses this information to provide accurate context during interviews, ensuring it understands your product features before asking about them.
Analysis
After sessions are completed, Stetos analyzes the transcripts to extract sentiments, key themes, and actionable feedback. This data is aggregated in your project dashboard.
Deployment Best Practices
To get the most high-quality insights from your users, consider these deployment strategies.
- Prime the User: Don't just pop up the widget unexpectedly. Use a button or link that says "Help us improve" or "Share your thoughts" to initiate the session.
- Give Context: In your agent's system prompt (Goal), clearly state who it is. E.g., "You are a friendly Product Researcher at Acme Corp."
- Start Broad, Then Drill Down: Configure your initial questions to be open-ended. "How was your experience today?" yields better stories than "Did you like feature X?"
- Review Transcripts Early: Read the first few interview transcripts to ensure the agent is behaving as expected. Tweak the goal or strictness settings if necessary.
Advanced Configuration
You can customize the widget's behavior by passing additional attributes to the script tag or the `StetosEmbed` component.
Default Mode
Force the widget to start in voice or chat mode.
Metadata
Pass user ID or other context to link the interview to your internal user records.
Help & Support
Need help? Chat with us directly.
We are building in public and love hearing from our users. Slide into our DMs for support, feedback, or just to say hi.
Message @Miguel_FeM