Everything you need to build, deploy, and scale AI agents with aiAgentOne
aiAgentOne is an enterprise Agentic AI platform that lets you create intelligent, autonomous AI agents trained exclusively on your own knowledge base. Unlike generic chatbots, our agents answer only from your verified content — ensuring accuracy, brand consistency, and zero hallucinations.
One script tag to add AI chat to any website
SOC2, GDPR compliant. Your data stays yours
Website widget, WhatsApp, REST API & more
The platform consists of these core components:
Get your first AI agent live in under 30 minutes:
Sign up at aiagentone.in/register. Free tier available — no credit card required.
Go to Dashboard → Agents → Create Agent. Give your agent a name, configure greeting messages, and set its personality.
Upload documents (PDF, DOCX, TXT), crawl a website URL, add FAQ pairs, or import via API. The platform automatically chunks, embeds, and indexes content for RAG retrieval.
Copy your agent's widget code and paste it before the closing </body> tag on your website. Your AI agent is now live!
Add the aiAgentOne chat widget to any website with a single script tag:
<!-- Add before closing </body> tag --> <script src="https://cdn.aiagentone.in/widget.js" data-agent-id="YOUR_AGENT_ID"></script>
YOUR_AGENT_ID with your agent's ID from Dashboard → Agents → Widget Code.Configure the widget appearance using data attributes:
<script src="https://cdn.aiagentone.in/widget.js" data-agent-id="YOUR_AGENT_ID" data-theme="light" <!-- light | dark --> data-position="bottom-right" <!-- bottom-right | bottom-left --> data-primary-color="#6366f1" <!-- Your brand color --> data-greeting="Hi! How can I help?" ></script>
| Attribute | Type | Default | Description |
|---|---|---|---|
| data-agent-id | string | — | Your agent ID required |
| data-theme | string | light | Widget theme optional |
| data-position | string | bottom-right | Widget position on page optional |
| data-primary-color | string | #6366f1 | Brand color for the widget optional |
| data-greeting | string | Hi! How can I help? | Initial greeting message optional |
Agents are the core of the platform. Each agent is an autonomous AI assistant trained on a specific knowledge base with configurable behavior.
The knowledge base is the source of truth for your AI agent. It uses RAG (Retrieval-Augmented Generation) with vector embeddings to find the most relevant content for each user query.
Every chat interaction is tracked as a conversation with full history, metadata, and analytics.
Deploy your AI agent across multiple channels from a single configuration:
All channels share the same knowledge base and agent configuration. Conversations from all channels appear in your unified dashboard.
The chat widget is the fastest way to add AI-powered support to your website. It loads asynchronously, is mobile-responsive, and supports light/dark themes.
The widget communicates with these backend endpoints:
The aiAgentOne REST API lets you programmatically manage agents, send messages, and manage knowledge bases. All endpoints follow RESTful conventions and return JSON.
https://api.aiagentone.in/v1
All responses follow this structure:
{
"success": true,
"data": { ... },
"message": "Operation completed"
}
Errors return appropriate HTTP status codes with a detail field:
// HTTP 400, 401, 403, 404, 422, 500 { "detail": "Description of the error" }
API requests are rate-limited to 100 requests per minute per authenticated user. Widget endpoints have a separate limit of 30 requests per minute.
API authentication uses JWT (JSON Web Tokens). Obtain a token by logging in, then include it in the Authorization header.
POST /api/v1/auth/login Content-Type: application/json { "email": "you@@company.com", "password": "your-password" }
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...
POST /api/v1/auth/refresh) to get a new access token without re-authenticating.Google OAuth is also available for seamless authentication:
POST /api/v1/agents Authorization: Bearer YOUR_TOKEN Content-Type: application/json { "name": "Support Agent", "description": "Customer support for our SaaS product", "greeting": "Hi! I'm here to help with any questions.", "system_prompt": "You are a helpful support agent..." }
POST /api/v1/chat/{conversation_id}/message Authorization: Bearer YOUR_TOKEN Content-Type: application/json { "message": "What is your return policy?", "agent_id": 13 }
{
"response": "Our return policy allows...",
"confidence": 0.92,
"sources": [
{
"title": "Return Policy FAQ",
"relevance": 0.95
}
],
"conversation_id": "conv_abc123"
}
Manage your agent's knowledge base programmatically. All knowledge endpoints are scoped to a specific agent:
curl -X POST \ https://api.aiagentone.in/v1/agents/13/knowledge/upload \ -H "Authorization: Bearer YOUR_TOKEN" \ -F "file=@product-manual.pdf" \ -F "title=Product Manual"
These endpoints power the embedded chat widget. They don't require JWT authentication — they use agent ID validation instead.
const response = await fetch('/api/v1/widget/session', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ agent_id: 13, visitor_id: 'visitor-uuid' }) }); const { session_id } = await response.json();
Webhooks allow you to receive real-time notifications when events occur in your aiAgentOne account. Configure webhook URLs in your dashboard settings.
conversation.started — A new conversation beginsconversation.message — A new message in a conversationconversation.ended — A conversation endsconversation.escalated — Conversation escalated to human agentagent.activated — An agent is activatedknowledge.updated — Knowledge base content is added or updated{
"event": "conversation.message",
"timestamp": "2026-02-11T10:30:00Z",
"data": {
"conversation_id": "conv_abc123",
"agent_id": 13,
"message": "What is your return policy?",
"response": "Our return policy allows...",
"confidence": 0.92
}
}