Fluo Docs
Build, embed, and operate AI agents through a small set of production APIs and a drop-in chat widget.
Fluo lets you turn a configured agent into something your product can use: a hosted chatbot, a server-side API call, or a streaming assistant experience inside your own UI.
Most teams start in one of two places:
| Path | Use this when | Start here |
|---|---|---|
| Embed a chatbot | You want the fastest customer-facing release with minimal engineering | Embed a Chatbot |
| Call the API | You want to run an agent from your backend, product workflow, or custom interface | Call the API |
What You Can Ship
- Website chatbots that answer from your agent configuration and knowledge.
- Streaming assistants that render responses as they are generated.
- One-off agent runs for support flows, enrichment jobs, form processing, and workflow automation.
- File-aware conversations where users upload documents or images for the agent to inspect.
Platform Objects
Fluo keeps the public surface small:
- Agents define behavior, instructions, model settings, knowledge, and tools.
- Threads store chat history for multi-turn experiences.
- Runs execute one request without carrying conversation history.
- Knowledge bases make uploaded content available to agents.
- Contexts provide structured memory or state when a run needs it.
- Integrations let agents read from or act in external systems when enabled.
Production Principles
Use server-side API keys for backend calls. For browser embeds, use a publishable embed key model: scoped to one agent, restricted to allowed domains, rate-limited, and capped by usage budget.
Keep secrets server-side:
Never place a full secret API key in frontend code, a public repository, or a widget snippet. Browser-facing credentials should be publishable, scoped, revocable, and safe to expose.
Next Steps
- Create and test your first agent.
- Embed a chatbot for the lowest-friction release path.
- Call the API from your application server.
- Review Authentication and the Production Checklist before going live.