CloudChef datasource
Reference data discovery skill (read-only).
Purpose
Query and browse reference data as standalone read-only operations. Use when
user wants to explore available options without submitting a request. This
skill owns standalone business-group scope discovery. Dedicated
resource-pool and resource skills still handle standalone resource-pool
and resource browsing.
Terminology Mapping
Treat SmartCMP business group as a generic organizational scope. Users may
describe the same concept as:
- tenant
- 租户
- 部门
- BU
- Department
- 项目
- Project
Resolve these terms against SmartCMP business-group data unless the user is
clearly referring to some other system-level tenant concept. Mirror the user's
wording in replies when it helps readability, but keep the SmartCMP field names
businessGroupName and bgId when calling scripts or building request data.
Trigger Conditions
Activate this skill when user intent matches:
| Intent | Keywords |
|---|---|
| View business-group scopes | "show business groups", "show tenants", "查看租户", "查看部门", "查看项目" |
| List applications | "list applications", "show apps" |
| List OS templates | "list OS templates", "available OS" |
| List images | "list images", "available images" |
NOT for: Resource provisioning -> use request skill instead.
NOT for: Catalog discovery -> use request.
NOT for: Direct "查询资源池", "查看所有资源", "查看所有云主机", or
"查看某个云主机详情" requests -> use resource-pool or resource.
Handlers
All five datasource Tool commands are co-located in scripts/adapter.py:
| Handler | Tool | Purpose |
|---|---|---|
list_all_business_groups |
smartcmp_list_all_business_groups |
List standalone business-group scopes |
list_applications |
smartcmp_list_applications |
List applications in a business group |
list_components |
smartcmp_list_components |
List component metadata for a catalog source key |
list_logical_templates |
smartcmp_query_logical_templates |
Query logical templates |
list_images |
smartcmp_query_images |
Query cloud images |
Catalog list/detail belongs to the request Skill Adapter. Resource
list/detail belongs to the resource Skill Adapter. The request Skill's
logical-template and image Tools are aliases to the two owning datasource
handlers; they do not create forwarding Python files.
The Adapter receives the selected instance and Authentication Context from AtlasClaw. SmartCMP Provider owns authentication, HTTP, pagination, normalization, and resource/catalog domain rules.
Workflow examples
- “Show available tenants or projects”: call
smartcmp_list_all_business_groups. - “List Linux logical templates”: call
smartcmp_query_logical_templateswithos_type=Linux. - “List images for this pool and logical template”: call
smartcmp_query_imageswith the exact three IDs/types required by the Tool schema.
Omit resource_bundle_id for a global logical-template directory query; pass
it to show only templates supported by one resource pool. A selected image
id is a templateId; it must never be serialized as physicalTemplateId.
Critical Rules
All operations are read-only - no data is created or modified.
Request aliases reference the owning datasource handlers; no implementation is copied or proxied through another Python process.
Standalone directory queries for all business-group scopes belong to
datasource. Standalone resource-pool and resource browsing belong toresource-poolandresource.
On error (
[ERROR]), report to user immediately; do NOT self-debug.
Error Handling
| Error | Resolution |
|---|---|
401 / Token expired |
Ask user to refresh cookie |
| Missing arguments | Check script usage in docstring |
References
- WORKFLOW.md - Detailed script usage and query flows