Quick Start

Build Your First AI Agent

Step-by-step guide to creating and deploying your first AI agent with Docimal.

Prerequisites

Before you begin, make sure you have:

  • A Docimal account (sign up for free)
  • At least one document (PDF, DOCX, TXT) or website URL to use as a knowledge source
  • Basic understanding of how AI chatbots work (optional)
Estimated time: This guide takes approximately 10 minutes to complete.

Step 1: Create a Workspace

Workspaces are the foundation of Docimal. They organize your projects, documents, AI agents, and team members in one place.

1

Log in to Docimal

Navigate to your dashboard at app.docimal.com

2

Access Workspace Selection

You'll see the workspace selection screen after logging in

3

Click "New Workspace"

Click the button to create a new workspace

4

Enter Workspace Details

Give it a descriptive name like "Customer Support", "Product Docs", or "HR Knowledge Base"

5

Click "Create"

Your workspace will be ready in seconds

Workspace Creation Modal

Step 2: Upload Documents

Your AI agent needs knowledge to answer questions. Upload documents, connect websites, or integrate with Notion and Confluence. Docimal will automatically process, chunk, and create vector embeddings for semantic search.

Supported formats:
PDFDOCXTXTCSVWebsitesNotionConfluenceREST APIs
1

Navigate to Knowledge Bases

Click the "Knowledge Bases" tab in your workspace

2

Create a Knowledge Base

Click "New Knowledge Base" and give it a name

3

Upload Your Files

Click "Upload Files" or drag and drop your documents. You can upload multiple files at once.

4

Wait for Processing

Docimal will chunk, embed, and index your documents. Processing typically takes 10-30 seconds per document. You'll see a checkmark when ready.

Document Upload Interface

Step 3: Configure Your Agent

Configure your agent's personality, appearance, and behavior to match your brand and use case.

Configuration Areas:
Identity
Name, prompt, tone
Appearance
Logo, colors, style
Behavior
Model, temperature
1

Navigate to Chatbot Settings

Go to the "Chatbot" tab, then click "Settings"

2

Configure Identity & Personality

  • Set your agent's name (e.g., "SupportBot")
  • Write a system prompt defining behavior
  • Choose personality (Professional, Friendly, Casual)
Example system prompt:
"You are a helpful customer support agent. Answer questions based on our documentation. Be professional and cite sources."
3

Customize Appearance

  • Upload your company logo
  • Set brand colors
  • Choose widget style (bubble, full-page, embedded)
4

Link Knowledge Base

Under "Knowledge" section, select which knowledge bases your agent can access

5

Choose AI Model

Select from GPT-4o, GPT-4o-mini, Claude Sonnet, or other supported models

6

Save & Publish

Click "Save Changes", then "Publish" to make it live

Chatbot Settings Dashboard

Step 4: Test & Deploy

Test your agent and deploy it to your website. Docimal offers multiple deployment options to fit your needs.

Testing Your Agent
1. Navigate to the "Test" tab in your chatbot dashboard
2. Ask questions that your agent should be able to answer
3. Verify the agent cites correct source documents
4. Refine your system prompt if needed
Deployment Options:
JavaScript Widget

Most popular. Add one script tag to any website.

Learn more
iframe Embed

Simple iframe for any platform. No JavaScript required.

REST API

Full control for custom integrations and mobile apps.

View API docs
1

Go to Deploy Tab

Navigate to "Deploy" in your chatbot dashboard

2

Copy Embed Code

Click "Copy JavaScript Code" or choose your preferred method

3

Paste into Your Website

Add the code snippet before the closing </body> tag

4

Test on Your Site

Refresh your website and you'll see the chat widget appear!

html
<script
  src="https://cdn.docimal.site/latest/docimal-chatbot.js"
  data-api-key="dcml_pk_YOUR_API_KEY"
  data-base-url="https://api.docimal.site/agents"
  async
></script>
Deployed Chat Widget
Congratulations!

You've successfully built and deployed your first AI agent. Your agent is now live and ready to answer questions based on your documents.