Editor
The agent editor at a glance — the layout, the side navigation and the action bar.
Editor
The editor is an agent's main configuration screen. Reach it through the pencil icon on the agent's card, or by navigating to the agent from the Agents page.
Layout
The screen has two areas:
- Left — the configuration sections: Definitions, Actions and Context.
- Right — the playground, where you test the agent live.
The playground always runs the current working version, not the one active in production. Changes you test there only reach production once you publish and activate a new version. See Versions.
Side navigation
The left menu reaches every section of the agent:
| Icon | Section | What it does |
|---|---|---|
| Robot | Agent | Opens the editor (this screen) |
| Variable | Arguments | Defines the agent's inputs and outputs |
| Bench | Test sets | Manages the test sets |
| Shield | Guardrails | Configures the safety filters |
| History | Runs | The run history |
| Versions | Versions | Publishing and managing versions |
| Gear | Settings | Name, model, integrations and more |
The top bar
| Button | What it does |
|---|---|
| Run (play icon) | Opens a menu with Test sets (runs every set) and Simulate the API |
| Chat (message icon) | Opens the agent's public chat in a new screen |
| Share (share icon) | A shortcut to the Sharing tab in Settings |
| Publish | Opens the modal for publishing a new version |
Simulating the API
Simulate the API (in the Run button's menu) opens a modal for testing the agent through an API call without leaving the editor:
- Inputs — fill in the agent's input arguments
- Response — the run's result appears as JSON, live
- Download — get a preconfigured Postman collection for the agent (
agent-{id}.postman_collection.json)
The Postman collection uses environment: 'production' and needs an active version to work. With no version active, the modal says so.
Saving
Changes in the editor save themselves. The status appears next to the agent's name at the top of the page:
- Saving… — the change is being sent.
- Saved — the change was saved.
- Could not save — it failed; check the connection and try again.