Skip to main content

Definition files

Everything that describes behaviour is YAML under config/agents/. Each kind below has its fields (generated from the JSON Schema the Rust structs export), the types they use, and the file this repository ships, in full. For how the files combine and what boot checks, see Configuration files.

KindFilesWhat it is
Workflowsconfig/agents/workflows/*.yamlA graph of task-kind nodes and the edges between them, compiled at boot. The agent list, the approval card and the run itself all come from this file. Each task kind's with parameters are listed under Task kinds.
Modelsconfig/agents/models.yamlThe model registry: which provider serves each model, its pinned revision and its license, checked against the allow-list in policies.yaml.
Promptsconfig/agents/prompts/*.yamlA versioned prompt for llm.extract: the system and user messages, and the limits on the untrusted document text placed in them. The llm.extract node names the model and the extraction schema.
Connectorsconfig/agents/connectors/*.yamlAn external system the platform calls: its kind, credentials, options and the actions that may be invoked, with whether each needs approval and is idempotent.
Toolsconfig/agents/tools/*.yamlA tool exposed to a model, bound to a connector action. Declared and validated; not yet wired into the model (see Project status).
Roles (rbac.yaml)config/agents/rbac.yamlRoles, what each can do, and what it inherits.
Policiesconfig/agents/policies.yamlPlatform-wide policy: allowed model licenses, retention, PII handling and rate limits.
Tenant overridesconfig/agents/tenants/*.yamlOne customer's differences, deep-merged over the shared definitions: thresholds, connectors, auto-approval.
Extraction schemasconfig/agents/schemas/*.yamlThe JSON Schema llm.extract output must satisfy.