suggest_table
Find the appropriate CMDB table for a configuration item by describing it in natural language. Returns ranked suggestions with confidence scores to help identify the best match.
Instructions
Suggest the best CMDB table to query based on a natural language description.
Given a description like "linux servers", "network switches", "web applications", or "load balancers", this tool searches the CMDB class hierarchy to find the most appropriate table. It queries sys_db_object and sys_documentation for class labels and descriptions to find the best match.
Use this tool when you're unsure which CMDB table to query for a particular type of configuration item.
Each suggestion includes a confidence score (0-100) indicating how well it matches the description. When a single result clearly dominates, it is marked as best_match.
Examples: suggest_table(description="linux servers") → cmdb_ci_linux_server suggest_table(description="network switches") → cmdb_ci_netgear suggest_table(description="web applications") → cmdb_ci_appl Vague descriptions like "stuff" or "things" will return low-confidence matches.
Args: description: Natural language description of what you're looking for. Examples: "linux servers", "network switches", "web applications", "database instances", "storage devices", "virtual machines". limit: Maximum number of suggestions to return (1-1000, default 10). offset: Pagination offset for retrieving subsequent pages of suggestions.
Returns: JSON object with "suggestions" — a ranked list of matching CMDB tables with their name, label, confidence score, and pagination metadata.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| description | Yes | ||
| limit | No | ||
| offset | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |