The Settings screen
Every gateway setting lives on one screen, organised into tabs. Only administrators can open it.
The AI Gateway Settings screen is a single configuration record. Each tab groups a related set of controls. The tables below define every field, its default, and what it controls.
General tab
| Field | Type | Default | What it controls |
|---|---|---|---|
| Enable AI Gateway | Toggle | On | The master switch. When off, no assistant can connect or run tools. |
| Connection URL | Read-only | Set by system | The address an AI assistant connects to. Copy this when setting up a client. |
| Discovery URL | Read-only | Set by system | The address the assistant uses to discover how to sign in. |
Capability Packs & Tools tab
| Field | Type | Default | What it controls |
|---|---|---|---|
| Enabled Packs | List | Core only | Which capability packs are switched on. Core is always on. |
| Pack Status | Live panel | n/a | A live view of installed packs and how many tools each provides. Refreshes on demand. |
Security tab
Code execution limits. These protect your environment when the assistant runs analysis code. They cap how long code can run and how much memory it can use.
| Field | Default | Range | What it controls |
|---|---|---|---|
| Execution Timeout (seconds) | 30 | 1–300 | The longest a single piece of analysis code may run before it is stopped. |
| Max Memory (MB) | 512 | 64–2048 | The most memory analysis code may use. |
| Max CPU Time (seconds) | 60 | 1–300 | The most processor time analysis code may consume. |
| Max Recursion Depth | 500 | 50–1000 | How deeply code may call itself. Keep the default unless advised otherwise. |
Audit log retention
| Field | Default | What it controls |
|---|---|---|
| Retention Period (Days) | 180 | How many days are the audit entries kept. Older entries are cleaned up automatically each day. Set to 0 to keep entries indefinitely. |
Document Recognition (OCR) tab
The gateway can read text from scanned documents and images. These settings control that capability.
| Field | Default | What it controls |
|---|---|---|
| Recognition Engine | Standard | Choose between the standard engine (fast, works out of the box, 80+ languages) and the enhanced engine for complex layouts. |
| Default Language | English | The language the recognition engine expects. Can be overridden per request. |
| Processing Timeout (seconds) | 120 | The longest the engine may spend on a document. |
| Max Memory (MB) | 2048 | The most memory the recognition process may use. |
Connection (MCP) tab
| Field | Default | What it controls |
|---|---|---|
| Connection Name | iVendNext AI Assistant | The name the assistant uses to identify your site during connection. |
| Protocol Version | Set by system | The connection standard version. Read-only. |
| Transport Type | Secure streaming | The connection method that enables secure sign-in. Read-only. |
| Skill Mode | Supplementary | How skills are delivered. Supplementary: tools keep their full descriptions and skills add extra guidance. Replace: tool descriptions are trimmed when a matching skill exists, which saves space in the conversation. |
Connection (OAuth) tab
| Field | Default | What it controls |
|---|---|---|
| Enable Dynamic Client Registration | On | Let assistants register themselves automatically. Required for desktop clients and testing tools. |
| Allowed Public Client Origins | Blank | For in-browser testing tools only. One address per line. Leave blank for normal desktop and web assistants. |
| Show Authorization Server Metadata | On | Publishes sign-in capability information for automatic discovery. |
| Show Protected Resource Metadata | On | Publish resource information so the assistant recognises your site. |
| Resource Name | iVendNext AI Assistant | The display name for your site as a data source. |
| Documentation URL | Set by system | A reference link shown to connecting clients. |
| Policy & Terms URLs | Blank | Optional links to your privacy policy and terms of service. |
| Supported Scopes | Default | The access scopes offered during sign-in. Leave blank to use the defaults. |
Screen actions
The Settings screen offers two buttons under its Actions menu:
Refresh Capability System: re-scans installed packs and tools and updates the live status panel.
Download Desktop Connector File: produces a ready-made connection file you can hand to a desktop AI client, so users do not have to enter the connection details by hand.