Documentation

Build your first governed agent.

Everything a developer needs to embed the panel, implement the adapter, and author agents — with worked examples across ABP, e-commerce, and ticketing. Integrate through two small seams, with no changes to the platform core.

Start integration See integration examples

adapter.ts

The five adapter methods

interface HostAdapter {
  validateToken(token)      // who is this user?
  getContext(ref)           // what are they looking at?
  getPermissions(user)      // what may they do?
  executeTool(tool, args)   // run an approved action
  pushNotification(msg)     // notify the host
}

Reference

Five guides to a governed agent.

Start with the integration guide, then dig into the adapter, contracts, cards, and API. Every guide assumes the governance gate — permission, policy, approval, audit; the platform controls around it are on the security page.

Integrate

Integration guide

Everything a developer needs to embed the panel, implement the five-method adapter, register the host, and author skills — with no changes to the platform core.

Reference

Adapter SDK

Your adapter is the authority on identity and permissions. Implement five methods — in-process in TypeScript or out-of-process over HTTP in any language.

Reference

Contracts

The two data contracts that flow across the seams — HostContext in, cards out — plus how contracts evolve additively and stay in Zod↔JSON-Schema parity.

Reference

Card types

Agents render results as typed cards — eight interaction card types and four presentation card types, twelve in all — so there is no custom UI to build.

Reference

API reference

An outline of the public run API, the admin authoring endpoints, and the internal governed callback — parameters and payload schemas are completed by engineering.

The Two Seams

The whole integration surface.

Allowix is the brain; your app is the body. The brain holds zero application-specific code — it connects to your system through exactly two generic seams (HostContext & HostAdapter).

Read the Integration Guide

Talk to us about integration.

We'll help you scope an adapter spike for your stack — the two seams, the governance gate, and a worked example close to yours.

Start integration Request a demo