docs(examples): rebuild quickstart-multidomain README as a smart data-retrieval walkthrough#52
Open
qiansheng91 wants to merge 1 commit into
Open
docs(examples): rebuild quickstart-multidomain README as a smart data-retrieval walkthrough#52qiansheng91 wants to merge 1 commit into
qiansheng91 wants to merge 1 commit into
Conversation
…-retrieval walkthrough Turn the default `make quickstart` pack's README (en + zh) from a terse reference into a guided "smart data-retrieval" demo aligned with the umodel-query skill — a 7-step walkthrough verified against live data: - discover the model (.umodel → 5 domains / 35 object types) - read objects (.entity → checkout-service degraded, …) and search (full-text + mode=vector/hyper) - traverse topology incl. the cross-domain devops→k8s `runs` edge (where-filter, not with) - discover an object's methods + its 3 datasets across Prometheus / Elasticsearch / MySQL - read metrics → prometheus_promql plan, logs → elasticsearch_dsl plan, then run them Real ids/values/plans throughout; links to the umodel-query / umodel-rca skills. Pack data unchanged (model and counts already correct); README only.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Turns the default
make quickstartpack's README (en + zh) from a terse reference into a guidedsmart data-retrieval (智能读数) walkthrough — the read-side companion to the
incident-investigation RCA demo. It pairs with the
umodel-queryskill.The walkthrough (7 steps, all verified against live
make quickstartdata).umodel→ 5 domains / 35 object types..entity→ checkout-service (degraded), catalog-api, delivery-service, telemetry-collector.query='checkout';mode='vector'/'hyper'for semantic ranking..topo getNeighborNodes … | where __relation_type__='runs'→ the cross-domain devops→k8s edge (useswhere; awith(...)clause does not filter graph-call output).__list_method__(4 methods) +list_data_set→ 3 datasets across Prometheus / Elasticsearch / MySQL.prometheus_promql,sum(rate(devops_service_request_total{service_id="…"}[1m])).elasticsearch_dsl, indexdevops-service-logs-*.Real ids/values/plans throughout; links to the
umodel-query/umodel-rcaskills. The MySQLevent_setis noted as modeled/discoverable (the plan-returning fetch methods today areget_metrics/get_logs).Scope
README only (en + zh). Pack model/sample-data unchanged — counts (35 entity sets, 93 entities,
125 relations) and structure were already correct, so
make example-validateis unaffected.