Skip to content
SynapsAI Docs

Create Your First Agent

This guide walks you through creating an agent from scratch, adding knowledge, and testing it in the playground — all in under 10 minutes.

Prerequisites

Section titled “Prerequisites”
  • A SynapsAI account. Sign up at synapsai.app if you don’t have one yet.
  • At least one document, FAQ list, or website URL you want the agent to learn from.

Step 1 — Access the console

Section titled “Step 1 — Access the console”

Navigate to console.synapsai.app and sign in. You’ll land on the Dashboard, which shows an overview of your agents and recent activity.

Step 2 — Create a new agent

Section titled “Step 2 — Create a new agent”
  1. Click Agents in the left sidebar.
  2. Click the Create Agent button.
  3. Enter a name for your agent (e.g., “Support Bot”).
  4. Choose a language — this sets the default language for the agent’s responses.
  5. Click Create.

You’ll be redirected to the agent’s configuration page.

Step 3 — Add knowledge

Section titled “Step 3 — Add knowledge”

Your agent needs data to answer questions. Head to the Knowledge Base section in the agent sidebar.

  1. Click Add Document.
  2. Choose a source type:
    • File upload — PDF, DOCX, TXT, or CSV files.
    • Text — Paste raw text directly.
    • Website — Provide a URL; SynapsAI will crawl and index the page.
    • FAQ — Upload a structured question-and-answer list.
  3. Upload or paste your content and click Save.

SynapsAI will chunk the content, generate vector embeddings, and index everything. This usually takes a few seconds for small documents.

Step 4 — Configure behavior

Section titled “Step 4 — Configure behavior”

Go to the Agents section and open your agent’s settings.

  1. Write a system prompt that defines the agent’s personality. For example:

    You are a helpful support assistant for Acme Corp. Answer questions using only the knowledge base provided. If you don’t know the answer, say so politely and suggest the user contact support@acme.com.

  2. Select a model — choose from the available LLM options based on your plan.
  3. Adjust temperature and max tokens if needed (defaults work well for most cases).
  4. Click Save.

Step 5 — Test in the playground

Section titled “Step 5 — Test in the playground”
  1. Open the Playground section from the agent sidebar.
  2. Type a question related to the knowledge you uploaded.
  3. The agent will retrieve relevant content and generate a response.
  4. Iterate on the system prompt and knowledge base until you’re satisfied with the quality.

Next steps

Section titled “Next steps”

Your agent is ready! Here’s what you can do next: