Agents
An agent is the runnable component of an agent swarm — the equivalent of an application component. It has its own Git repository, build pipeline and default configuration, is created from an agent template, and runs in every environment where its swarm is deployed.
On top of what a component has, an agent:
- runs as a service account (configured per environment),
- is registered in the Agent Gateway and can be called by other agents and users (A2A),
- can call models, MCP servers and other agents through the gateway,
- receives the environment described in Agent Runtime.
Repository Structure
The repository follows the component structure: .codenow.yaml, .codenow.triggers.yaml, the build descriptor, codenow/config/ and the source code. In addition, the agent template ships .codenow.config.yaml with the agent's default configuration, including the agentGateway section — see Default Configuration.
What You Can Do
| Action | Description |
|---|---|
| Create a new agent | Select a name and an agent template |
| View agent detail | Agent info, builds, merge requests and default configuration |
| Open / Clone repository | Access the agent's Git repository |
| Setup instructions | Set up the agent for local development |
| Connected services | Service bindings the agent needs |
| Manage merge requests | Create and review merge requests for the agent repository |
| Manage permissions | Control who can view, develop or administer the agent |
| Configure CI | Build image, CI provider, variables and branch settings |
| Delete agent | Permanently remove the agent and its repository |