Agent not found

You configured an agent, restarted, and selecting it by key returns a not-found error.

Almost every instance is one of three things, in the order worth checking:

1. The path in agents.toml is wrong. It is relative to the config root, and it points at the directory, not at agent.toml:

[[agents]]
config_dir = "agents/support"

2. The key is not what you think. The directory name is only an organization choice - the key inside agent.toml is the name you select with, and the two do not have to match. Open the file and read the actual value.

3. CONFIG_DIR points somewhere else. Especially likely if you have more than one checkout, or a container mounting a different path than the one you edited.

Configuration is read at startup, so also confirm the process was restarted after your change.

Next

• Create your first agent - the two files and how they relate.
• Troubleshoot a deployment - if the agent loads but misbehaves.