Deploy your first agent

This tutorial takes you from a brand-new account to an agent that is working and answering you. It takes a few minutes of clicking, then a short wait while Qoren sets the agent up. You can answer the agent's setup questions during that wait.

Before you start#

• A Qoren account. If you do not have one yet, create an account first.

That is all. You do not need a server, an API key for the AI model, or anything installed on your computer.

You do not need a plan either. A new account starts with free credits, and they pay for a first environment of the smallest size and an agent from a template on it: its hosting, the model's work on Qoren's key and its web searches all come out of them. The console tells you while you are on free credits. When they run out, start the 7-day free trial to keep going; the trial needs a card and turns into the plan you picked after 7 days, unless you cancel before then.

If you already know you want more than that, such as a bigger environment, several agents or an email inbox, choose a plan first under Settings, then Billing. What each plan includes, and what happens when free credits run out, is in Plans and the free trial. During the trial, add credits to use Qoren's key, or bring your own key.

The quick way: a suggested agent#

The first time you sign in, the Welcome to Qoren screen asks what brings you to Qoren and what your first agent should take off your plate, then shows the template that fits best, with two more under Also a good fit. Click Deploy and Qoren does steps 1 to 3 below for you with the template's default settings, in a few seconds: it orders an environment of the smallest size your plan or free credits allow, creates the agent on it straight away, and opens it. The agent's setup waits for the environment by itself, so it carries on even if you close the page. Carry on from step 4.

A template that needs one of your own keys, such as a Gmail account, says so before you deploy it. Deploy still orders the environment, then the welcome screen hands you to the Create an agent page to fill in the key and click Create agent, which you can do before the environment is up. To change anything before the agent is made, click Customize first instead.

The steps below are the same flow done by hand, which is also how you add every agent after the first.

Step 1: Pick what the agent does#

1. In the sidebar, click New agent. The Create an agent page asks you to pick what your agent should do.
2. Browse the templates, or type in the search box (1) to find one by name or description. The category buttons under it narrow the list.
3. Click the template you want (2). Each card says in one line what that agent does.

123

Nothing quite fits? Click Design your own (3) and describe the job in your own words. An AI designer drafts a template with you and opens it in the template editor, where Create an agent from this brings you back to this flow. See Design an agent with AI.

Step 2: Set up an environment (first agent only)#

Your agent needs an environment to live on: a private computer in the cloud that Qoren runs for you. If you already have one, Qoren picks it for you and you can skip to step 3.

If this is your first agent, the page says Set up an environment first.

1. Click Set up an environment.
2. Give the environment a name (1), such as main. Spaces turn into dashes as you type.
3. Choose a size (2). Sizes are named by how many agents the environment holds. The box at the top shows how many credits the chosen size draws per hour while it runs. Sizes your plan does not include are greyed out with Upgrade to unlock. On free credits, that is every size but the smallest.
4. Click Create environment (3).

123

Qoren sends you straight back to your agent while the environment is created. The form shows Your environment is still starting, which usually takes a minute or two. You do not have to wait for it: carry on with the next steps and click Create agent, and the agent's setup starts by itself as soon as the environment is ready, whether or not you stay on the page. For more on sizes, see Environment sizes.

If you run agents for clients and have Clients turned on, the form first asks Which client is this for? The agent then goes on one of that client's environments. See Clients.

Step 3: Name the agent and create it#

1. Under Name your agent (1), keep the template's name or type your own.
2. Under Runtime (2), leave the runtime the template picked. It is the agent software underneath, and the template's own choice is the safe one. You can pick another; see Runtimes for what changes.
3. Under Connect your tools, the template's tools are tiles with their logos. A tool marked Required needs its key: click its tile, follow the link to create the key with the access it lists, and paste it, or pick a key you saved before under Or use a saved key. Every other tool can wait: click Connect later and add the keys later in the agent's Settings. See Connect your tools.
4. Leave Let this agent search the web (3) ticked if the agent should look things up. Each web search draws credits from your balance.
5. If your plan includes email inboxes, choose under Email inbox (4) whether this agent gets an address of its own. No email inbox is fine for now; you can add one later. See Give an agent an email address.
6. Click Create agent (5).

12345

The agent starts on your default AI model. You can switch models any time after it is set up.

Step 4: Answer a few questions while it sets up#

Qoren opens your new agent's page on the Chat tab. The status next to its name reads Setting up (1), with the step it is on next to it. Setup usually takes 10 to 15 minutes.

Instead of a silent wait, a setup assistant asks you a few quick questions about the job (2). It already knows your business details, so it does not ask who you are. Type your answer and press Enter. Your answers are saved as you go, so you can close the page and come back.

123

Rather not answer now? Click Skip for now, I'll chat when it's ready (3). You can change your mind with Answer a few setup questions while you wait.

When the agent comes online, the chat carries on with the agent itself. It already has your answers, and it writes you its first message. A copy of your answers is also saved in its workspace as SETUP-INTERVIEW.md.

While setup runs, the Tasks, Triggers and Workspace tabs and some sections of Settings are locked. They open as soon as setup finishes. If setup seems stuck, see Setup is taking a long time.

Step 5: Finish setting up#

When the status reads Working, a Finish setting up checklist (1) sits above the chat with up to two steps:

• Connect a chat channel, so people can reach the agent on Telegram, Slack or Discord, not only in Qoren. Click Connect.
• Add the keys its tools need, if its tools call services that need an API key. Click Add keys.

12

Neither step is required. Click Skip on a step the agent does not need, or close the checklist. Both live in the agent's Settings whenever you want them. See Finish setting up an agent.

Step 6: Send your first message#

1. Click the message box (2) and type what you want. Ask it what it will do for you, or give it its first task.
2. Press Enter or click Send (3). Shift+Enter starts a new line.

1234

Replies can take a while, because the agent does the work before it answers. Conversations are saved to your account: open earlier ones from History (4), or start a fresh one with New chat. More in Chat with an agent.

That is it: your first agent is live. From here, give it a schedule, connect a chat app, or watch what it does on its Activity tab.

If something stops you#

• Choose a plan first. Your account has no plan and no free credits left to spend. Click Choose a plan and pick one, or start the 7-day free trial.
• This blueprint needs a bigger environment. The template needs an environment that holds more agents than yours. Click Manage environments to resize one or add a bigger one, then come back.
• This environment is full. Every size holds a set number of agents. Resize the environment or add another one. On free credits, your one environment of the smallest size holds one agent, so a second agent needs a plan or a trial.
• An error says an agent with that name already exists. Two agents on one environment cannot share a name. Pick another name.
• Please fill in followed by a key name. The template needs that key. Type it, or pick it from the Vault.
• A red note under Runtime says the runtime can't run scheduled tasks. The template has scheduled tasks and the runtime you picked cannot run them. Pick another runtime.
• Out of credits. A strip under the top bar says your agents are paused. Top up your credits and try again. Free credits cannot be topped up: when they are used up, the console shows when your environment will be deleted, with a button to start your 7-day trial. Start it before then to keep going. See when your free credits run out.