Skip to content

Latest commit

 

History

History
60 lines (44 loc) · 1.95 KB

File metadata and controls

60 lines (44 loc) · 1.95 KB

Atlanta Civic Data Agent

A conversational agent that answers natural-language questions about Atlanta public transit data, rendering its answers as generated UI rather than text. Built for Hack RenderATL 2026.

Language

Domain

Harvest: The scheduled ingestion of a public dataset from its source into our own store. Avoid: Sync, scrape, ETL, refresh

Service Frequency: The number of transit trips serving a given stop over a given period. The primary measure behind every equity claim the agent makes. Avoid: Headway, service level

Transit Desert: An inhabited area whose Service Frequency falls below the threshold needed to reach essential services by transit. A conclusion the data supports, never a field in it. Avoid: Underserved area, transit gap

Stop: A single boarding location. The unit that Service Frequency is measured against.

Route: A named public-facing transit line. One Route serves many Stops.

Trip: One scheduled traversal of a Route at a specific time. Counting Trips per Stop yields Service Frequency.

Protocols

These three are routinely confused with one another. They are not interchangeable.

A2UI: Google's Agent-to-UI spec. The agent emits declarative UI blueprints; the client renders them with its own components. This is how our answers become interfaces. Avoid: Generative UI, AG-UI, A2A

AG-UI: CopilotKit's Agent-User Interaction protocol. The transport carrying events between our agent and the frontend. Complementary to A2UI, which rides on top of it. Avoid: A2UI, CopilotKit protocol

A2A: Google's Agent-to-Agent protocol, for delegation between separate agents. Deliberately unused — we run a single agent. Named here only to keep it distinct from A2UI. Avoid: Using it as a synonym for A2UI

Storage

Store: The queryable home of harvested data, reached through one adapter interface so the backing engine can change without touching the agent. Avoid: Database, warehouse, cache