Appearance
Agent keys
Create a project-scoped API key for an agent and review its activity.
1. Create an agent and key
Select the workspace name at the top of the sidebar, then Workspace settings → Agents. Enter an Agent name, choose Personal or Shared, and select Create. Select the agent, then select Issue key. Choose Default Project, enter a Key label if you want one, and select Issue key. Copy the key before leaving the page; it is shown once.
Keys issued in the web app have the five :write scopes in this table.
| Scope | What it allows |
|---|---|
metrics:write | Start runs and write metrics. |
logs:write | Write logs. |
artifacts:write | Write artifacts and media. |
traces:write | Write traces. |
evals:write | Write eval results. |
2. Use the key
Set RUNDIAL_API_KEY in the agent's environment to the issued key, then follow Trace an agent. Keep the key out of source control.
3. Review or revoke access
Select the agent in Workspace settings → Agents to see Keys and Audit. Select Revoke to revoke the agent and its active keys.