Agent Gateway

The Agent Gateway lets an approved external agent delegate a StatiBeat turn into the backend Agent V5 runtime. It uses the same capability runtime as the web assistant and Slack assistant, so external agents do not receive their own orchestration path.

Endpoint

Purpose	Endpoint
Generate a delegated response	POST /admin/agent/v5/delegations/respond
Mark a response as delivered	POST /admin/agent/v5/delivery
Record feedback	POST /admin/agent/v5/feedback

Request Shape

Delegated turns use the Agent V5 turn contract:

• transport is delegation
• message_markdown contains the user-visible request
• conversation_key and thread_key identify the delegated conversation
• delegation identifies the delegating agent, authority, and requested actions
• recent_turns may include short recent user and assistant messages

The backend derives organization, page, user, and permission context from the authenticated request. Client-supplied IDs are hints only.

Response Shape

Responses return:

• message_markdown as the primary answer
• optional artifacts for evidence, timelines, tables, or previews
• optional actions for confirmation-first writes
• optional citations
• trace metadata for prompt versions, selected capabilities, model/provider, grounding size, and latency

External agents should render the natural answer first, then render artifacts and actions only if present.

Safety Rules

Delegated writes never execute blindly. Agent V5 re-checks permissions, validates grounded evidence, asks for confirmation when a mutation is proposed, and records turn events for replay and audit.