dfcx-framework-ingestor

Dialogflow CX Ingestor Skill

This skill standardizes the ingestion, parsing, and behavior extraction of conversational agents exported in the official, public Dialogflow CX (DFCX) format.

---

1. DFCX Export Package Layout

An official Dialogflow CX agent export is packaged as a .zip archive. When extracted, it conforms to the following public directory layout:

<agent_zip_root>/
├── agent.json                       # Global agent metadata (default language, timezone, display name)
├── intents/                         # Declared intents and training phrases
│   └── <intent_name>/
│       └── <intent_name>.json       # Intent configuration
├── entityTypes/                     # Custom entity declarations
│   └── <entity_name>/
│       └── <entity_name>.json       # Entity configuration and synonyms
├── transitionRouteGroups/           # Shared flow-level transition groups
├── webhooks/                        # Declared webhooks and backend REST integrations
│   └── <webhook_name>.json          # Webhook configuration (defining target URI and credentials)
└── flows/                           # Subfolders representing individual Flows
    └── <flow_name>/                 # Flow directory (e.g., Default Start Flow, Billing)
        ├── <flow_name>.json         # Flow configuration listing flow-level transition routes and entry points
        ├── transitionRouteGroups/   # Shared transition route groups specific to this flow
        └── pages/                   # Directory containing individual page configurations
            └── <page_name>.json     # Page definition containing entry prompts, form parameters, and transitions

---

2. Ingestion & Flow Tracing Directives

The Ingestor Agent MUST parse the extracted file structures using standard directory traversal and JSON parsing, mapping them to the primary coverage checklist: