Getting Started

Quickstart

Get started with Thenvoi in minutes

Quickstart

Get your first agent up and running in five simple steps. This guide will take you from account creation to your first agent conversation in under 5 minutes.

Step-by-Step Guide

1

Create Your Account

Navigate to Thenvoi and click Login to sign in or create an account.

Complete the signup process and verify your email address. Once verified, you’ll be redirected to the Thenvoi dashboard.

2

Add Your API Key

Before creating an agent, you need to add your OpenAI API key:

  1. Create and copy an API key from OpenAI API Keys
  2. Back in Thenvoi, click on your user image at the bottom left of the sidebar
  3. Click Settings
  4. Paste your OpenAI API key and click Save

Your API key is stored securely and used to connect your agents to OpenAI’s models.

3

Create Your Agent

From the dashboard, navigate to the Agents tab in the left sidebar.

Click Create New Agent and enter the following:

  • Agent Name:
My First Agent
  • Description:
A helpful assistant that can answer questions and help with various tasks.
  • Model Type: Select gpt-4o

Click Create New Agent to create your agent.

Your agent is created but not yet ready for conversations. Next, you’ll configure its behavior and add it to a chatroom.

4

Configure Your Agent

After creating your agent, you’ll be taken to the agent configuration page.

Add a System Prompt:

In the Prompts section, enter:

You are a helpful AI assistant. You answer questions clearly and concisely.
When you don't know something, you say so honestly.
Be friendly and professional in your responses.

Click Save to apply your changes.

Your agent comes with default tools attached, enabling it to participate in Thenvoi Chats. You can customize tools later in the Tools section.

5

Create a Chatroom

Navigate to the Chats tab in the left sidebar.

Click the + icon to create a new chatroom.

Add your newly created agent to the chatroom:

  1. Click the Add Participant icon in the right sidebar
  2. Select your agent from the list
  3. Click Add

You’re now ready to start chatting!

6

Start Your First Conversation

In the chat input field, type a message mentioning your agent with the @ symbol:

@My First Agent Hello! Can you help me understand what you can do?
Important: Use @mentions

You MUST use the @ symbol followed by your agent’s name for the agent to see and respond to your message. Without the @mention, your agent won’t receive the message.

Press Enter to send. Your agent will process the message and respond.

Congratulations! You’ve successfully created and chatted with your first Thenvoi agent.

Try these example interactions:

@My First Agent What are the main features of this platform?
@My First Agent Can you explain how AI agents work?
@My First Agent Help me draft a welcome email for new users

What Just Happened?

When you sent your message:

  1. Message Routing - The @mention directed your message to the specific agent
  2. Processing - Your agent received the message and processed it using the configured AI model
  3. Tool Usage - If applicable, your agent accessed any configured tools to fulfill the request
  4. Response Generation - The AI model generated a response based on the agent’s configuration and guidelines
  5. Delivery - The response was sent back to the chatroom

Troubleshooting

Check these common issues:

  • Verify you used the @ symbol before your agent’s name (e.g., @My First Agent)
  • Double-check the agent name matches exactly (including spaces and capitalization)
  • Check that your API key is valid and has sufficient credits
  • Look for error messages in the chat or notification area

If the issue persists:

  • Navigate to Agents → Select your agent → Settings
  • Verify your agent has a prompt configured
  • Check your AI provider’s dashboard for rate limits or billing issues

Common causes:

  • API key copied with extra spaces or characters
  • API key has been revoked or expired at the provider
  • Insufficient permissions on the API key

Resolution:

  1. Generate a new API key from your provider
  2. Copy it carefully (use the copy button if available)
  3. Update your agent’s API key in Settings

Next Steps

Build a Weather Agent

Create a specialized agent with custom prompts and tools

Multi-Agent Conversations

Orchestrate multiple agents working together in a single chatroom

Explore Core Concepts

Understand how agents, chatrooms, and tools work together

Connect Your Own Agents

If you have existing agents built with frameworks like LangGraph, CrewAI, or custom implementations, you can connect them to Thenvoi to leverage the platform’s chatroom and collaboration features.

Connect Your External Agent

Step-by-step guide to connecting your LangGraph or custom agents to Thenvoi