Agents - Roark Docs

A voice agent. Thin by design; endpoints are nested and fanned out on apply. References nothing.

# yaml-language-server: $schema=https://schema.roark.ai/roark-config.schema.json
kind: agent
name: frontdesk
description: Bright Smiles front desk booking agent
customId: bright-smiles-frontdesk
endpoints:
  - name: outbound-primary
    value: '+15551234567'
    direction: INCOMING_AND_OUTGOING

name is the local key (^[a-z0-9][a-z0-9-_.]*$) and, with the kind, forms the config identity.
endpoints[] each take a name, a value (E.164 phone number), a direction (INCOMING, OUTGOING, or INCOMING_AND_OUTGOING), and an optional environment.
Other resources reference an agent by its name (e.g. a flow’s agents: list, or a collector’s AGENT filter).

For the full field reference of every kind, see the Config DSL reference schema.