$npx -y skills add GoogleCloudPlatform/cxas-scrapi --skill cyaraExtracts conversational transcripts from Cyara XML test case files.
| 1 | # Cyara Ingestor Skill |
| 2 | |
| 3 | Use this skill when you need to extract dialogue turns and conversation flows |
| 4 | from Cyara XML test case files. |
| 5 | |
| 6 | ## Protocol |
| 7 | |
| 8 | Cyara files are XML documents containing test scenarios for voice or chat |
| 9 | agents. They are rich sources for transcripts because they map user utterances |
| 10 | to agent states. |
| 11 | |
| 12 | 1. **Identify Test Cases**: Look for elements representing individual test |
| 13 | cases using their unique identifiers. |
| 14 | 2. **Extract Utterances**: Extract the list of sample user utterances. These |
| 15 | are valuable for generating realistic User turns. |
| 16 | 3. **Parse Expected Flow**: Locate the `expected_flow` sequence, which |
| 17 | describes the chronological steps of the interaction. |
| 18 | 4. **Map Turns**: |
| 19 | * Iterate through the `expected_flow`. |
| 20 | * Look for steps that include `(User: ...)` annotations. This directly |
| 21 | maps what the user said at that specific point in the flow. |
| 22 | * The step names (e.g., `Greeting_State`, `Ask_Identifier`) indicate the |
| 23 | Agent's state or prompt. You must infer natural Agent dialogue based on |
| 24 | these state names if literal text is not provided. |
| 25 | 5. **Voice-Realism Enforcement**: Ensure the inferred dialogue strictly |
| 26 | enforces the main skill's **Agent-First**, **Voice Realism (No Spoken |
| 27 | URLs)**, and **Standardized End Session** (closing with `end_session` tool |
| 28 | call) rules. |
| 29 | 6. **Extract Metadata**: Look for intent tags to understand the high-level |
| 30 | classification. |
| 31 | |
| 32 | ## Example |
| 33 | |
| 34 | A summarized Cyara item might look like this: `yaml id: test_case_identifier |
| 35 | utterances: |
| 36 | |
| 37 | - I need help with my account expected_flow: |
| 38 | - Welcome_Prompt (User: I need help with my account) - Request_Account_ID` |
| 39 | |
| 40 | You should infer a transcript like: |
| 41 | |
| 42 | - User: "I need help with my account." |
| 43 | - Agent: [Triggers Welcome Prompt and recognizes intent, proceeding to Request |
| 44 | Account ID] |