Public Links
Shareable URLs that let unauthenticated users chat with agents. Supports optional email verification, session persistence, per-user memory, and rate limiting.
Concepts
•Public Link — A unique URL (e.g.,
/public/chat/{token}) that allows anyone to chat with an agent without logging in.•Email Verification — Optional. If enabled, users must verify their email before chatting. Rate limiting is applied per-email.
•Session Persistence — Multi-turn conversations persist across page refreshes. Sessions are email-based (verified) or anonymous.
•Per-User Memory — Email-verified sessions maintain persistent per-user memory scoped to
(agent_name, user_email). Updated via background summarization every 5 messages.•Dynamic Thinking Status — Real-time status labels showing agent activity (same as authenticated chat).
How It Works
1
Open the agent detail page and go to the Sharing tab.
2
Click Create Public Link.
3
Configure the link: email verification on/off, rate limits, custom welcome message.
4
Copy the generated URL and share it with recipients.
5
Recipients open the URL and start chatting immediately.
6
If email verification is enabled: the user enters their email, receives a verification code, verifies, then chats.
7
Conversations persist — the user can return later and continue where they left off.
8
Click New Conversation to start a fresh session.
API Endpoints
| Endpoint | Method | Description |
|---|---|---|
| /api/agents/{name}/public-links | GET | List public links |
| /api/agents/{name}/public-links | POST | Create a public link |
| /api/agents/{name}/public-links/{id} | PUT | Update a public link |
| /api/agents/{name}/public-links/{id} | DELETE | Delete a public link |
| /api/public/chat/{token} | POST | Send a message via public chat |
| /api/public/history/{token} | GET | Retrieve chat history |
Limitations
•Rate limiting applies per user or session.
•Anonymous sessions have no cross-session continuity.
•Per-user memory requires email verification to be enabled.