Your agents follow your rules within your environment.
Form.io's Universal Agent Gateway (UAG) sits between AI agents and your Form.io project. Agents read your forms to learn what to collect and how to behave. Every value they send back is checked against the form's own validation and saved according to the user's permissions, all within your own environment.
Or install the Form.io Agentic Coding Plugin and have your coding agent make your forms agent-ready.
npx skills add formio/ai
See each feature, live.
The examples show one feature at a time on a small, ordinary form: what it does, the form settings that turn it on, and every call it makes to the UAG.
Fill an online form from a scanned paper form
Upload a scan of a paper form filled in by hand, and the online form fills itself in from it.
Try it WORKFLOWSRun an agent task after a submission
Saving the form starts an agent, which saves its answers back to the submission.
Try it CHAT WIDGETChat widget
Any form tagged uag can be filled in as a chat, and is checked and submitted the same way.
Try itOne form for people and agents.
Form.io's renderer turns form JSON into an interface for people. The UAG turns the same JSON into context for agents: the fields, the rules, the allowed values and the instructions.
- Change a field or an instruction in the form builder, and agents pick it up on the UAG's next refresh.
- People and agents are checked by the same validation rules.
- Agents automatically find the forms you tag, so you write no per-form agent code.
Agents inherit your users' permissions.
A prompt can't enforce permissions, so the UAG does. Every agent request goes through the same authentication, permissions and validation as a person using your application.
No model holds a write tool
Engines return answers, and the UAG validates each value and writes it once, itself. Text in a submission can't get a model to change your records.
Your RBAC, unchanged
Agents authenticate through your existing Form.io login, SAML or OIDC, and act with exactly the permissions of the person or service they represent.
A record of every decision
Each decision records its engine, model, confidence and source. With Form.io Enterprise, submission revisions show who changed what, human or agent.
Confidence thresholds
Decision engines answer closed questions with a confidence score. Below the threshold you set, the field is left for a person to answer.
Re-decided on the server
Values decided in a browser can be tampered with. An "Agent: Run task" action before the save decides again on the server, and fields marked authoritative take only its answer.
Change it without a deploy
Rewrite the instructions in the form builder and agents follow them from the UAG's next project refresh, with no restart. To undo a change, restore an earlier form revision.
Your data stays with you.
Run the UAG next to Form.io in your own cloud, data center or air-gapped environment. It needs no public endpoint, and with a local model no data leaves your network.
- One container on Docker or Kubernetes, beside your Form.io deployment.
- Private by default: your applications connect out to the UAG; no public endpoint, no tunnel.
- Local models through Ollama or vLLM, or engines isolated on their own server so model keys stay out of the gateway.
- Enterprise ready: RBAC, FIPS-compliant deployments, form and submission revisions, stage deployments.
- Open source under the MIT license, so you can read the code that handles your data.
The right engine for every field.
Closed choices go to a decision engine that reports its confidence. Open values go to an agent engine such as Claude. Changing models is a configuration change.
With and without the UAG.
Agents wired straight to your data
- Business rules live in prompts and drift between agents
- Models hold write access to your systems
- Every new form means new agent code
- No record of which model decided what
- Data leaves your security boundary
Agents through the UAG
- One JSON schema governs people and agents alike
- The UAG validates and writes; models only answer
- New forms are discovered, not coded
- Provenance on every decision and value
- Self-hosted, with local models when you need them
Let your coding agent build it.
The Form.io Agentic Coding Plugin gives Claude Code, Cursor, Codex and other coding agents that read skills the Form.io skill library, including the formio-uag skill. Describe what the agent should do, and your coding agent tags and writes your forms for agents, designs their tasks, deploys the UAG and its engines, and wires your application to it.
- Its example prompts build a chat that fills in a form, an agentic workflow and a self-filling wizard in your own project.
- The plugin writes forms through the Form.io MCP server and shows you each change before it saves.
- Settings that open a form to anonymous users or spend model credits are listed separately for you to confirm.
# In your application's folder
npx skills add formio/ai
# Or, in Claude Code, the plugin with the Form.io MCP server
/plugin marketplace add https://github.com/formio/ai.git
/plugin install formio-ai@formioPut a chat on our public support page where customers describe their problem to an AI agent. The agent then interviews the user for the necessary information and submits our "serviceRequest" form for them.Take it to production.
Enterprises have built their data collection on Form.io for more than a decade. Ready to go live? Run the UAG in your own environment, on your infrastructure and under your control. Talk to Sales about a deployment license and support options.