Agents
Agents
Agents are workspace resources assembled from reusable parts: a model, system prompt, tools, skills, knowledge scope, and external connections.
An agent belongs to a selected space. Central Hub stores its configuration and each run receives the authenticated user, space, selected files, and resolved connector credentials.
Authentication
Send a bearer token for a user request or a scoped API key for a service integration. Include the selected workspace on every space-scoped request:
Authorization: Bearer <oidc-token>
X-Space-Slug: acmeFor API-key calls, replace the first header with X-API-Key: sk-....
Agent building blocks
| Part | Configuration |
|---|---|
| Model | model_config_id |
| Prompt | system_prompt or prompt_template_id |
| Runtime tools | tool_names |
| Reusable instructions | enabled_skill_slugs, enabled_skill_set_slugs |
| Files knowledge | enabled_file_scope |
| Data and SaaS access | enabled_connection_ids |
| Remote tools | enabled_mcp_connection_ids |
The create and configure guide shows the complete payload. The Agents API reference contains every current endpoint.