Andreas Hilbig
b56255ffaa
This commit introduces a comprehensive set of GraphQL query and mutation samples based on the official Zabbix 7.4 API documentation, along with testing and automation improvements. Changes: - Documentation: - Added 21 GraphQL sample files in docs/queries/from_zabbix_docs/ covering various Zabbix API operations. - Updated docs/howtos/cookbook.md with a new recipe for executing these documentation samples. - AI & MCP: - Added mcp/operations/importHostGroups.graphql to enable host group import via MCP tools. - Testing: - Added src/test/zabbix_docs_samples.test.ts to automatically validate all documentation samples against the GraphQL schema. |
||
|---|---|---|
| .. | ||
| cookbook.md | ||
| hierarchical_data_mapping.md | ||
| maintenance.md | ||
| mcp.md | ||
| permissions.md | ||
| README.md | ||
| schema.md | ||
| tags.md | ||
How-To Guides
This directory contains detailed guides on how to use and extend the Zabbix GraphQL API.
Available Guides
🍳 Cookbook
Practical, step-by-step recipes for common tasks, designed for both humans and AI-based test generation.
📊 Schema and Schema Extension
Learn about the GraphQL schema structure, how Zabbix entities map to GraphQL types, and how to use the dynamic schema extension system.
🗂️ Hierarchical Data Mapping
Understand how the API automatically maps flat Zabbix item keys into nested GraphQL objects using hierarchical resolvers and type hinting.
🔐 Roles and Permissions Extension
Discover how the permission system works, how to define permission levels using Zabbix template groups, and how to query user permissions.
🛠️ Technical Maintenance
Guide on code generation (GraphQL Codegen), running Jest tests, and local Docker builds.
🤖 MCP & Agent Integration
Discover how to integrate with the Model Context Protocol (MCP) to enable LLMs and autonomous agents to interact with Zabbix efficiently.
🔍 Additional Resources
- Sample Queries: Categorized list of practical GraphQL operation examples.
- Main README: Technical reference, configuration, and environment setup.