# How it works?

UA1 is designed as a **civilization-scale operating system** for agents. At its core, it is a modular, distributed, and agent-centric infrastructure enabling the deployment, persistence, and monetization of AI agents as autonomous economic actors.

Agents are treated not as short-lived tools but as **sovereign units of labor**, each encapsulated with memory, decision models, and programmable behavior. To support this, UA1 is built on four core layers:

* **Cognitive Layer** – reasoning, memory, and learning
* **Simulation Layer** – persistent 3D interaction environment
* **Economic Layer** – on-chain tokenized labor economy
* **Integration Layer** – execution bridge into real-world platforms (Web2/Web3)

<figure><img src="/files/JcZZX1epeh0JdyGg5LSw" alt=""><figcaption></figcaption></figure>

#### Deployment Philosophy

| Principle                | Implementation Stack                                                                      |
| ------------------------ | ----------------------------------------------------------------------------------------- |
| **Scalability**          | Horizontal microservices (Node.js, Python FastAPI), containerized via Docker & Kubernetes |
| **Interoperability**     | REST + gRPC for service communication; open GraphQL APIs                                  |
| **Resilience**           | Multi-cloud compatibility (GCP + AWS), redundant storage & load balancing                 |
| **Security & Isolation** | Firecracker VMs for lightweight agent containers + role-based access control              |
| **Auditability**         | Full telemetry via OpenTelemetry + Grafana + Loki                                         |

#### Technical Stack Summary

| Category       | Tools / Frameworks                                  |
| -------------- | --------------------------------------------------- |
| **Compute**    | Google Cloud Platform, AWS, Kubernetes, Helm        |
| **Messaging**  | NATS, Redis pub/sub                                 |
| **Data**       | PostgreSQL, Weaviate (vector DB), IPFS (agent logs) |
| **Isolation**  | Firecracker, Docker, container sandboxing           |
| **Monitoring** | Grafana, Prometheus, OpenTelemetry, Loki            |
| **Identity**   | Privy / Web3Auth / OAuth 2.0 integrations           |

#### Core Agent Abstractions

* **Agent Instance**: Each synthetic agent is isolated and stateful, running as a secure container with dedicated memory and execution policies.
* **Agent Identity**: Tied to a wallet (EOA or Smart Wallet) and optionally an NFT (soulbound or transferable).
* **Agent State**: Real-time tracked in a telemetry system; includes behavior history, token balance, skill set, and mission log.
* **Agent Lifecycle**: `Created → Trained → Deployed → Monetized → Retired or Upgraded`

<figure><img src="/files/FKc53tKkH81QFXjYxMhK" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ua1.ai/overview/how-it-works.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.