Cognova
All Docs

Getting Started

Welcome to Cognova — a managed AI agent platform powered by Claude. This guide walks you through the basics of setting up your workspace and creating your first agent.

Create Your Account

  1. Sign up at cognova.dev/register
  2. Verify your email address
  3. Your default workspace is created automatically

Your First Agent

Agents are the core of Cognova. Each agent has a system prompt, a model tier, and optional tool bindings.

  1. Navigate to Agents in the sidebar
  2. Click New Agent
  3. Give it a name (e.g., "Code Reviewer") and a system prompt describing its role
  4. Choose a model tier:
    • Fast (Haiku) — quick responses, low cost
    • Balanced (Sonnet) — best for most tasks
    • Pro (Opus) — maximum capability
  5. Save and start chatting

Agent Delegation

Your default agent automatically gets delegation tools (ask_[name]) for every other enabled agent. This means you can ask your default agent to route requests to specialists without switching agents manually.

For example, if you have a "Code Reviewer" agent and a "SQL Expert" agent, your default agent can call either one when the conversation demands it.

Add Tools

Tools give agents the ability to take actions — call APIs, reference documentation, or run code in a sandbox.

  1. Go to Tools in the sidebar
  2. Click Create Tool and choose a type (HTTP, Knowledge, or Sandbox)
  3. Configure the tool definition and save
  4. Navigate to your agent's settings and attach the tool

Every agent also has built-in tools (tasks, memory, files, code execution) available automatically. See the Custom Tools guide for full details.

Upload Knowledge

Knowledge bases let agents reference your documents when answering questions.

  1. Go to Knowledge in the sidebar
  2. Upload files (Markdown, text, code, JSON)
  3. Assign knowledge directories to specific agents in their settings

Agents automatically retrieve relevant content from their knowledge base during conversations.

Invite Your Team

Cognova is workspace-based — your whole team shares agents, tools, knowledge, and a credit pool.

  1. Go to Settings > Workspace
  2. Click Invite Member
  3. Choose a role: Owner, Admin, or Member

What's Next?