# Cxas Protocol Two Phase Ingestion

> A two-phase protocol for extracting structure and generating transcripts from customer artifacts.

- Skill: `googlecloudplatform/cxas-protocol-two-phase-ingestion` (Agent Skill)
- Install (CLI): `npx skillmds@latest add googlecloudplatform/cxas-protocol-two-phase-ingestion`
- Raw SKILL.md: https://api.skillmd.com/api/skills/googlecloudplatform/cxas-protocol-two-phase-ingestion/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: GoogleCloudPlatform (https://skillmd.com/u/googlecloudplatform)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/googlecloudplatform/cxas-protocol-two-phase-ingestion

---


# Two-Phase Ingestion Protocol

This protocol defines a strict two-phase process for analyzing customer
artifacts to extract system structure and generate high-fidelity conversation
transcripts.

## Phase 1: Structural Digestion

-   **Goal**: Extract raw data from artifacts into a digestible form (e.g., YAML
    or structured Markdown).
-   **Scope**: Map the exact Taxonomy, Intents, Tools, Connections, state
    transitions, and node logic.
-   **Rule**: DO NOT infer transcripts during this phase. Focus purely on
    structural extraction.
-   **Exception**: If explicit transcripts are already present in the raw data
    (e.g., inside Cyara XML test data), they can be extracted directly.

## Phase 2: Transcript Generation

-   **Goal**: Generate full natural conversation transcripts based on the
    digested structural data.
-   **Mechanism**: Use LLM reasoning to read the structural data and generate
    transcripts.
-   **Rule**: Must use the `./append_turn.py` script (located in the parent skill directory)
    to build transcripts turn-by-turn to ensure schema compliance.