Skip to main content

Getting Started with Basic Agents

Learn how to create a basic AI agent that can answer questions using your content—and share it, embed it, or connect it wherever you need. Agent Diagram

What is an Agent, and Why Use One?​

An agent is like a smart assistant that can answer questions and help users—powered by AI.

In Optimly, you can create these agents to:

  • Answer questions based on your own content (like PDFs, websites, or documents).
  • Help customers, teammates, or users get fast and helpful responses.
  • Learn what people are asking and improve your content or support.

Think of it like having a supercharged FAQ bot—but one you can train in minutes and monitor in real time.

There are different types of agents depending on how you want to use or share them. A Basic Agent is the simplest way to get started. You can use it privately or share it through a link with anyone—no coding or installation required.

Setting Up a Basic Agent​

To create a Basic Agent:

  1. Go to the Agents section of your Optimly dashboard.
  2. Click + Add.
  3. Select Basic Agent.

You’ll then go through the following configuration steps.

Create agent

1. Knowledge Configuration​

Before your agent can answer questions, you need to ground it with relevant knowledge sources.

Supported knowledge sources include:

  • PDFs and text files
  • Google Drive documents
  • Website URLs
  • YouTube videos
  • Custom FAQs or structured knowledge bases

These sources help the agent answer with greater accuracy and relevance.

Create knowledge

2. Agent Configuration​

Define how your agent should behave and what powers it.

Main configuration options:

  • Behavior: Describe your agent’s tone, personality, and response style. Use the prompt generator to help write clear instructions.
  • Model: Choose the LLM backend (e.g., GPT-4, GPT-4o mini). Different models have different costs and capabilities.
  • Knowledge Restrictions: Decide if the agent should only answer based on your uploaded content. You can also define fallback behavior if no relevant knowledge is found.
  • Accessibility: Choose between public, password-protected, or private access.
  • Domain Settings: Set up a custom subdomain (e.g., https://agent.yourdomain.com) for white-labeled sharing.
  • Emoji Support: Enable or disable emoji use in agent responses.

Agent configuration

3. Customization​

Make your agent visually consistent with your brand or use case.

Customization options include:

  • Agent Name: Choose a name that reflects the agent’s function.
  • Welcome Message: Set an optional greeting message that appears when a user opens the chat.
  • Theme Selection: Pick from pre-built color schemes or define your own using hex codes.
  • Appearance Settings: Adjust fonts, colors, backgrounds, and layout using a live preview window.

Agent Customization

Sharing Your Agent​

Once configured, you can share your agent through a direct link.

To share:

  1. Click the ... menu on the agent card.
  2. Select Copy share link.
  3. Send the link to anyone who should have access.

You can manage accessibility settings to control who can interact with the agent. Agent Public access

Viewing Conversation History​

You can review all past interactions with your agent:

  1. Click the ... menu on the agent’s card.
  2. Select Conversations.

You’ll be redirected to the Conversations page, where all user-agent exchanges are stored and available for analysis. Agent public view

Need help setting up your first agent? Contact support or visit the Getting Started page.