Architecture

Technical Architecture

Project structure, execution modes, and planning engine.

Back to Overview

Project Structure

project-phoenix/ |-- domains/TennisAgent/cli/ # CLI: main.py, chat.py, nli_parser.py |-- cockpit_poc/ # Analyst's Cockpit GUI | |-- tkinter_cockpit.py # Multi-device visualization | |-- agent/ # Agentic Cockpit (deterministic, phased UI) | `-- chatkit/ # ChatKit Mode (LLM-driven, LangGraph) |-- PyAI/ # Documentation |-- ORIGINAL_DOCUMENTATION/ # Tau-bench reference docs `-- validate/ # Ground truth validation tools

Execution Modes

CLI

Direct tool execution and natural language queries.

Analyst's Cockpit

GUI visualization for multi-device and multi-modal analysis.

Agentic Cockpit

Four-phase deterministic execution with plan previews and controls.

ChatKit Mode

LLM-driven mode used for development experimentation.

Planning Engine

PlanBuilder converts natural language into deterministic tool sequences using regex pattern matching. Execution is orchestrated by a state machine in the Agentic Engine.