Skip to content
Docs

Your own agents

Build an agent from scratch or a template, or fork an official one and change anything.

In Agents → Your agents → Create agent you have three ways to start:

Start fromYou get
ScratchAn empty agent with a name and a role.
TemplateA one-time copy of an ORYVOX template.
ForkA copy of an official agent, or your instance of one, that you can change completely.

A fork copies the agent's files only: not its versions, deployments, runs, usage, approvals, memory, secrets, connections or overrides. It has no update link to the original: ORYVOX updates won't reach it.

What an agent is made of

An agent is a package of files, edited in Files and compiled into a version:

Part
IdentityPersona, role, mission, voice, languages.
BehaviourInstructions, objectives, priorities, constraints, conversation and decision policies.
KnowledgeWhich knowledge it reads.
ToolsWhich capabilities it needs and how it may use them.
MemoryWhat it may remember, and for how long.
HandoffWhen and to whom it hands over.
TestsScenarios it must pass before release.
RuntimeModel policy, limits, retries.

Files can be validated, compared with earlier versions, exported as a zip and imported back.

Release

Publishing compiles the files into an immutable version. Failing checks block publishing. Deploy that version to Development, then Production; roll back any time.

Was this page helpful?