Action

An Action is a discrete operation that an Agent can invoke. It is the unit of work in the Service/Action layer. Actions are exposed by Services and can be composed into workflows.

Examples

• send_email — send an email to a recipient
• query_database — run a SQL query
• call_api — invoke an external HTTP API
• upload_file — store a file in the file store

Schema

Every Action declares:

• Input schema (parameters it accepts)
• Output schema (what it returns)
• Error conditions
• Required permissions

Invocation

Agents invoke Actions through the City layer. The City routes the request to the Service that owns the Action, then returns the result to the Agent.

Composition

Actions can be composed into higher-level workflows. For example, a "onboard user" workflow might invoke create_account, send_welcome_email, and add_to_crm in sequence.

Continue with:

• Model Provider
• Service