Technical

Agents

A builder and monitor for AI agents that combine model instructions with callable tools and logged runs.

Open in app All docs

Public and internal interfaces

These are the main routes, handlers, and integration surfaces used by this product area.

GET /api/portal/agents POST /api/portal/agents PATCH /api/portal/agents/{id} DELETE /api/portal/agents/{id} POST /api/portal/agents/{id}/test GET /api/portal/agents/runs GET /api/portal/agents/runs/export GET/POST/PATCH/DELETE /api/portal/mcp/tools

Architecture notes

Agent React hooks live in caveauai-web/src/lib/agents.ts.
The Agents page reuses the MCP Tools tab for tool creation and testing.
Agent functionality is plan-gated; Team plan or higher is required for builder access.

Access and permissions

App pages are authenticated through the shared bnl_session cookie unless explicitly marked public. Public docs should describe integration behavior without including secrets, private tokens, private IPs, or tenant-specific records.

Troubleshooting

A 403 card means the current plan does not include agent builder access.
Tool failures should be debugged in Tools before blaming the agent prompt.