Skip to main content
Agents are created and configured using a coral-agent.toml file. Every agent in Coral (Server, Console, Cloud and Marketplace) has exactly one coral-agent.toml file.

​
Syntax

A coral-agent.toml file is written in TOML. This file has a single top level field, edition and 3 tables.

​
Edition

The top-level edition field is a number indicating the edition of the coral-agent.toml file, allowing the Coral server and other applications to quickly identify whether or not they are compatible. The current edition is 4

​
Tables

​
1. [agent]

Basic information about the agent, such as its name and version. This table is required, and many of its fields are required.

​
2. [runtimes]

The runtimes table contains a definition of:
  • An executable runtime
  • A Docker runtime
  • A prototype runtime
The Coral server will execute the specified runtime as requested by an application. At least one runtime must be specified

​
3. [options]

The options table contains up to 512 unique options that allow your agent to be configured at runtime, by applications. Options are optional; however, almost every agent will have options. Options are for example used for:
  • API keys used by LLMs
  • API keys or tokens used by MCP servers
  • Prompting adjustments