Zentrix Gateway User Manual
Complete operating instructions from first-time setup through daily use, security governance, troubleshooting, and platform maintenance.
Back to overview · Download full PDF
Version note: this manual matches the 2026.10 release. Content is checked against the 2026-10-22 mainline code and the production console. Screenshots are from the 2026-10-21 to 10-22 runtime; object names and values in screenshots are for illustration only. Which menus and features you see depends on the delivered edition, the modules in the license, and the account's permissions.
About this manual
Scope
This manual applies to Zentrix Gateway 2026.10 and is written for:
| Reader | Primary chapters |
|---|---|
| Platform administrators (first-time setup and daily operations) | Chapters 1–12, 15–18, 24–26 |
| Security and compliance staff | Chapters 3, 13–15, 22 |
| Operations staff | Chapters 19–23, 26–27 |
| Members and application developers | Chapters 8, 10 |
Which menus and features you see depends on the delivered edition, the modules in the license, and the account's permissions.
Conventions
- Menu paths are separated with 「›」, for example 「Admin Console › Traffic rules › New rule」.
- Buttons, fields, and option names on the console are marked with 「」; API paths, request headers, error codes, and configuration examples use code formatting.
- Placeholders such as
<网关地址>and<YOUR_API_KEY>in examples must be replaced with real values. Names of models, model groups, and departments are examples only. - 「Note」 flags when a change takes effect, what it affects, and easy-to-miss points. 「Capability notes」 lists capabilities the product does not provide and the available alternatives.
Screenshots
Screenshots in this manual come from a live environment. Organization names, object names, and values in screenshots are for illustration only and do not match your environment. The screenshot environment is a full edition deployment with agent capabilities, so:
- The brand name in the top-left corner and on some pages is that environment's branding. Your environment shows the brand name your organization configured (see section 24.8 「Branding & appearance」);
- The 「Agents」 group in the sidebar (role templates, channel management, agent operations, and similar) is available only in the full edition. The Zentrix Gateway edition does not show those menus; the remaining menus and operations are the same.
Document structure
| Part | Chapters |
|---|---|
| Part 1. Getting to know Zentrix | Chapter 1 Zentrix overview and first-run setup, Chapter 2 Platform objects and boundaries |
| Part 2. Organization, models, and distribution | Chapter 3 Organization and permissions, Chapter 4 Configure model providers, Chapter 5 Model pricing and categories, Chapter 6 Models and model groups, Chapter 7 Configure model-group availability scope and quotas |
| Part 3. Use and calling | Chapter 8 Members using models, Chapter 9 Callers and API keys, Chapter 10 Calling the APIs |
| Part 4. Connecting capabilities | Chapter 11 Configure and distribute MCP services and API services, Chapter 12 External agents, skills, plugins, and external registries |
| Part 5. Security and traffic governance | Chapter 13 Configure sensitive-data (PII) detection, Chapter 14 Configure content detection and safety fences, Chapter 15 Traffic rules and traffic protection, Chapter 16 Gateway extensions and Open API |
| Part 6. Usage, observability, and diagnosis | Chapter 17 View usage and control cost, Chapter 18 Usage and cost analysis, Chapter 19 Observability entries, data sources, and permission boundaries, Chapter 20 Gateway requests, sessions, and root-cause location, Chapter 21 Problem diagnosis and handling |
| Part 7. Audit and operations | Chapter 22 Alerts, notifications, retention, export, and operation audit, Chapter 23 Platform runtime and day-to-day maintenance, Chapter 24 Maintaining and changing common configuration |
| Part 8. Go-live and handover | Chapter 25 Phased go-live, Chapter 26 Go-live checks, stable operation, and management handover, Chapter 27 Information needed when contacting support |
| Appendix | A Role and entry quick reference, B Common task index, C Error codes and handling suggestions, D Capability notes |
All chapters
| Chapter | Read online |
|---|---|
| 1. Zentrix overview and first-run setup | Read |
| 2. Platform objects and boundaries | Read |
| 3. Organization and permissions | Read |
| 4. Configure model providers | Read |
| 5. Model pricing and categories | Read |
| 6. Models and model groups | Read |
| 7. Configure model-group availability scope and quotas | Read |
| 8. Members using models | Read |
| 9. Callers and API keys | Read |
| 10. Calling the APIs | Read |
| 11. Configure and distribute MCP services and API services | Read |
| 12. External agents, skills, plugins, and external registries | Read |
| 13. Configure sensitive-data (PII) detection | Read |
| 14. Configure content detection and safety fences | Read |
| 15. Traffic rules and traffic protection | Read |
| 16. Gateway extensions and Open API | Read |
| 17. View usage and control cost | Read |
| 18. Usage and cost analysis | Read |
| 19. Observability entries, data sources, and permission boundaries | Read |
| 20. Gateway requests, sessions, and root-cause location | Read |
| 21. Problem diagnosis and handling | Read |
| 22. Alerts, notifications, retention, export, and operation audit | Read |
| 23. Platform runtime and day-to-day maintenance | Read |
| 24. Maintaining and changing common configuration | Read |
| 25. Phased go-live | Read |
| 26. Go-live checks, stable operation, and management handover | Read |
| 27. Information needed when contacting support | Read |
| Appendix A. Role and entry quick reference | Read |
| Appendix B. Common task index | Read |
| Appendix C. Error codes and handling suggestions | Read |
| Appendix D. Capability notes | Read |