.. _auto_ontology_analysis: *ONTOLOGY ANALYSIS* =================== Provides a no-SPARQL abstraction layer for querying and comparing entities in an RDF/OWL ontology store. Supports seven analysis modes — list, get, find-related, compare, find-common, find-exclusive, and aggregate — against any named ARC2 triple store. Use this worker when an AI agent or workflow step needs structured ontology introspection without hand-written SPARQL. When to use ----------- Tagged: ``aggregate``, ``ai-agent``, ``arc2``, ``compare``, ``entity-analysis``, ``graph-traversal``, ``ontology``, ``owl``. Inputs ------ .. list-table:: :header-rows: 1 :widths: 20 20 20 20 20 20 * - Label - ID - Type - Default - Required - Description * - Ontology Store Name - ontology_store_name - text - — - ✓ - Name of the ARC2 RDF triple store to analyze; the prefix 'arc2_ontology_' is added automatically if absent — e.g. 'vehicle_model' resolves to 'arc2_ontology_vehicle_model'. * - Analysis Type - analysis_type - select - — - ✓ - The operation to perform: 'list_entities', 'get_entity', 'find_related', 'compare_entities', 'find_common', 'find_exclusive', or 'aggregate' — each has specific required companion inputs described below. * - Entity Type - entity_type - text - — - - RDF node type to target, matching an OWL class in the store schema (e.g. 'SystemModel', 'Assembly'); required for all analysis types. * - Entity IDs - entity_ids - text - — - - Comma-separated entity ID(s) to operate on (e.g. 'SM_001' or 'SM_001,SM_002'); for get_entity/find_related up to 5 IDs are accepted, compare_entities requires exactly 2, find_common requires 2+, find_exclusive accepts 1+. * - Relationship Path - relationship_path - text - — - - Comma-separated relationship names defining the traversal path; a single name for direct hops (e.g. 'hasAssembly') or multiple names for multi-hop traversal (e.g. 'hasSimulation,hasResponse'); required for find_related, find_common, find_exclusive, and aggregate. * - Direction - direction - select - outgoing - - Edge traversal direction for find_related: 'outgoing' (source→target, default), 'incoming' (target→source), or 'both'; leave as default unless reverse or bidirectional traversal is needed. * - Exclude Entity IDs - exclude_entity_ids - text - — - - Comma-separated entity IDs to exclude from results; used with find_exclusive to remove specific parent entities from the uniqueness comparison. * - Filter Result Properties - filter_result_properties - text - — - - Comma-separated list of property names to retain in result rows; omit to return all properties. * - Results Filter Key - results_filter_key - text - — - - Legacy single-property filter key; prefer the 'results_filter' JSON input for new workflows — used only when results_filter is empty. * - Results Filter Value - results_filter_value - text - — - - Value paired with results_filter_key for legacy single-property filtering; ignored when results_filter JSON is provided. Outputs ------- .. list-table:: :header-rows: 1 :widths: 20 20 20 20 * - Label - ID - Type - Description * - Status - status - text - Machine-readable status string ('success' or an error code) indicating whether the analysis operation completed without errors. * - Results - results - dataset - Primary analysis output as a tabular dataset; schema varies by analysis_type (entity properties for list/get, traversal results for find_related, counts for aggregate, etc.). * - Summary - summary - text - Human-readable prose summary of the analysis findings, suitable for display in a report or agent response. * - Result Count - count - number - Integer count of the total number of rows returned in the 'results' dataset. * - Property Differences - property_diff - dataset - Tabular dataset of property-level differences between the two compared entities; populated only for compare_entities, empty otherwise. * - Relationship Differences - relationship_diff - dataset - Tabular dataset of relationship-level differences between the two compared entities; populated only for compare_entities, empty otherwise. * - Children Only in First Entity - child_only_in_first - dataset - Dataset of child entity names present exclusively under the first entity; populated only for compare_entities. * - Children Only in Second Entity - child_only_in_second - dataset - Dataset of child entity names present exclusively under the second entity; populated only for compare_entities. * - Children in Both Entities - child_in_both - dataset - Dataset of child entity names shared by both compared entities; populated only for compare_entities. * - Child Similarity Percentage - child_similarity_percentage - number - Percentage of child entity names that overlap between entities (for compare_entities only). * - Overall Change Percentage - overall_change_percentage - number - Weighted average of all property change percentages (for compare_entities only). * - Nested Properties Differences - nested_properties_diff - dataset - Property-level differences from nested properties objects like Response metrics (for compare_entities only). * - Nested Properties Change Percentage - nested_properties_change_percentage - number - Average change percentage for nested properties (for compare_entities only). Disciplines ----------- - ai_ml.agents - ai_ml.domain_reasoning - platform.ontology .. raw:: html

Auto-generated from platform schema. Worker id: ontology_analysis. Schema hash: 9657ba91a90b. Hand-curated docs in workerexamples/ override this page when present.