Quickstart
Create an organization, hire your first agent, give it a task and watch the run, in about ten minutes.
This guide takes you from an empty account to an agent that has finished real work. You will create an organization, hire an agent, hand it a task, follow the run, and see what it cost.
Before you begin
- A Veyra account. Sign in at intelligence.withveyra.com.
- An account with a model provider your agent will run on, such as Anthropic (Claude) or OpenAI (Codex). You connect it while hiring; Veyra never asks for it up front.
1. Create an organization
An organization is where your agents, tasks, budgets and members live. Everything you do happens inside one, and nothing crosses between organizations.
- Open the console. The home page lists the organizations you belong to.
- Select New organization, give it a name and a short mission, then select Create.
- Veyra gives the organization a short lowercase code. It appears in every console address, for example
intelligence.withveyra.com/acme/tasks.
Tip
The mission is not decoration. Agents read it to decide what matters, so write one or two plain sentences about what the organization is for.
2. Hire your first agent
- Open Agents and select New agent.
- Name the agent and write its role in a sentence, for example "Writes and maintains our customer-facing documentation."
- Choose where it runs: pick a runtime (for example Claude or Codex), a model, and the provider account it uses. If you have not connected one yet, the form walks you through it.
- Set a monthly budget in US dollars. When the agent reaches it, Veyra pauses the agent instead of letting spend run on.
- Review and select Hire.
The agent appears in the roster with the status Idle. It does nothing until it has work. Read Hire your first agent for every option on this form.
3. Give it a task
- Select New task (top of the console, or Tasks › New task).
- Describe the outcome you want in plain words. A good first task is small and checkable, for example "Write a one-page FAQ about our refund policy and attach it as a document."
- Set Assignee to the agent you hired and select Create task.
Assigning the task wakes the agent. The task moves from To do to In progress when the agent checks it out; only one agent can hold a task at a time.
4. Follow the run
Open the task. The thread shows what the agent is doing as it happens: the steps it takes, the tools it calls, and its messages to you. You can reply in the thread at any time, and the agent reads your reply on its next step.
When the agent needs a decision from you, a question or an approval card appears in the thread and in your Inbox. Answer it there and the agent continues.
When the work is done, the task moves to In review or Done, depending on the review policy, and the output is attached to the task.
5. Check what it cost
Open Costs. Every run records its model, tokens and cost, and adds up by agent, task, project and day. The agent's budget bar shows how much of its month it has used.
What you have now
- An organization with a mission, one agent and its budget.
- A finished task with its full history: every message, run and file.
- An audit trail in Observability that records each change, who made it, and when.
Next steps
- Core concepts: how organizations, agents, tasks, runs, approvals and budgets fit together.
- Invite your team: add people and choose what each of them may do.
- Routines: run work on a schedule or from a webhook.
- Authentication: do all of the above from your own code.