Skip to main content
Agentset provides a prebuilt chat interface for each namespace, giving you a unique URL to test and share your RAG setup without building a custom UI.
Agentset hosted chat interface

​
Enable hosting

Open your namespace in the dashboard and navigate to Hosting to enable the hosted interface.
Enable hosting from namespace settings

​
Custom domain

Connect your own domain to serve the hosted interface from a branded URL. To configure a custom domain:
  1. Add your domain in the Custom Domain field
  2. Create a CNAME record pointing to cname.agentset.ai
  3. Save and wait for DNS propagation

​
Protection

Restrict access to specific users by configuring email or domain allowlists.
SettingDescriptionExample
EmailAllow specific email addresses to access the hosted page[email protected], [email protected]
DomainAllow all users from specific email domainscompany.com, example.org

​
Customize the interface

Configure the appearance and behavior of your hosted chat interface from the dashboard.

​
Hosting details

SettingDescription
TitleDisplay name shown in the chat interface header
SlugUnique identifier for your hosted URL (e.g., my-assistant creates app.agentset.ai/a/my-assistant)
LogoCustom logo image displayed in the interface

​
Chat settings

SettingDescription
LLM ModelLanguage model for generating responses
Reranker ModelModel used to rerank retrieved documents
Top KNumber of documents to retrieve from the vector store (1-100)
Rerank LimitNumber of documents to keep after reranking (1-100)
System PromptInstructions that define how the assistant behaves
Welcome MessageInitial message shown to users when they open the chat
Citation Metadata PathMetadata field to display as the citation label instead of chunk IDs (e.g., title or source.filename for nested fields)
Example QuestionsStarter questions shown to users to help them begin a conversation

​
Search settings

SettingDescription
Enable SearchAllow users to search through your documents directly
ExamplesSuggested search queries shown to users

​
Manage hosting via API

​
Enable hosting

import { Agentset } from "agentset";

const agentset = new Agentset({
  apiKey: process.env.AGENTSET_API_KEY,
});

const ns = agentset.namespace("YOUR_NAMESPACE_ID");

const hosting = await ns.hosting.enable();
console.log(hosting);

​
Get hosting configuration

const hosting = await ns.hosting.get();
console.log(hosting);

​
Update hosting settings

const hosting = await ns.hosting.update({
  title: "My Knowledge Base",
  welcomeMessage: "Welcome! Ask me anything.",
  systemPrompt: "You are a helpful assistant...",
  exampleQuestions: [
    "What is RAG?",
    "How do I upload documents?",
  ],
});

​
Disable hosting

await ns.hosting.delete();
console.log("Hosting disabled");

​
Next steps

  • API Reference — Hosting endpoint parameters and options
  • Search — Learn about search configuration options
  • Ranking — Understand how reranking improves results
  • Citations — Configure citation formatting