# Overview

Device Agent is an MQTT-powered AI Assistant that turns any IoT device into an AI agent in minutes.
Describe a device or upload a hardware definition to generate its specification, SDK, simulator, and IM/A2A integration.

## What You Can Build

- **Define a Device Agent**: describe telemetry, commands, and events, then turn a device category into a conversational, connectable, and collaborative capability model.
- **Generate a device SDK**: produce runnable device-side code and reduce handwritten protocol parsing and connection boilerplate.
- **Debug with a simulator**: validate device interaction, command responses, and conversation behavior before the hardware prototype is ready.
- **Connect voice, vision, and IM channels**: let users interact with devices through natural language, image context, or chat tools.
- **Build an A2A hardware network**: let device agents discover each other, coordinate tasks, and collaborate across devices without hardcoded automation rules.

## Who It Is For

**Smart device manufacturers** can use Device Agent to validate an AI upgrade path without building a full AI, voice, and multimodal stack from scratch.

**AI hardware teams** can structure product capabilities in an Agent-native way from day one, giving devices conversational, callable, and collaborative interfaces.

**System integrators** can reduce one-off private API integrations and hardcoded automation rules, then deliver cross-brand device collaboration through standard protocols.

**Developers** can start from device models, MQTT access, SDK access, simulator flows, and A2A examples to understand the complete engineering path.

## Basic Workflow

1. **Describe the device**: enter a natural language description or upload a JSON, Markdown, or YAML device definition.
2. **Confirm the capability model**: review telemetry fields, commands, events, and version information.
3. **Create the agent**: generate the Device Agent and enable A2A publishing when needed.
4. **Connect the device**: use MQTT, the simulator, or a generated SDK to connect real hardware.
5. **Expand interaction channels**: add voice, vision, IM, or external agent network integration based on the scenario.

- [Installation](./installation.md)
- [Quick Start](./quick-start/quick-start.md)
- [Define a Device Agent](./usage/create-agent.md)
- [A2A Collaboration](./usage/a2a.md)