> For the complete documentation index, see [llms.txt](https://docs.kiloiot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kiloiot.io/kilo-docs-pt/kilo-iot-server/ai-assistant.md).
# Assistente de IA IoT
O Assistente de IA do Kilo IoT conhece a sua implementação e pode provisionar dispositivos, implementar regras e configurar alarmes consigo.
A maior parte da "IA" em software é uma caixa de chat adicionada a uma página de ajuda. O assistente do Kilo IoT Server é algo completamente diferente: **um integrador de IoT experiente que vive dentro da sua plataforma, conhece toda a sua implementação e pode fazer o trabalho consigo.** A diferença entre uma ferramenta que responde a perguntas e um colega que assume tarefas.
Pergunte-lhe o que os seus dispositivos estão a fazer e ele responde com base na sua telemetria real. Peça-lhe para configurar algo — integrar um dispositivo, criar uma automatização, definir um alarme — e ele faz o trabalho, mostra-lhe exatamente o que vai alterar e só prossegue depois de o aprovar. Abra-o a partir de **Chat de IA** na barra lateral.
## Três coisas tornam-no diferente
**Está ancorado na sua implementação, não a adivinhar.** Todas as respostas sobre os seus dispositivos, regras, alarmes e painéis vêm dos seus dados em tempo real — lidos na plataforma no momento em que pergunta, delimitados pelas suas permissões. Não enche as respostas com generalidades plausíveis; se não conseguir obter algo, diz isso. Isso torna-o suficientemente fiável para agir com base nele.
**Ele age, não se limita a aconselhar.** Este é o salto. O assistente pode aprovisionar um dispositivo ou um gateway, criar uma automatização completa — escrevendo a [CEL](/kilo-docs-pt/kilo-iot-server/rules-engine/cel-reference.md) lógica e implementando-a — criar um alarme com escalamento, **executar um comando num dispositivo**, recomendar hardware compatível e gerir o acesso da equipa. Executa as mesmas operações que faria, em seu nome, e verifica o próprio trabalho depois, lendo novamente o resultado.
**Lembra-se e confirma.** Mantém o contexto da sua conversa e da sua configuração, para que possa aperfeiçoar uma tarefa ao longo de várias mensagens sem recomeçar do zero. E antes de qualquer coisa destrutiva ou com consequências — eliminar um dispositivo ou regra, resolver um alarme — faz uma pausa e pede um **Confirmar ação** / **Cancelar**. Nada irreversível acontece sem a sua autorização.
## O que pode fazer por si
| | |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Compreender a sua implementação** | Responder a perguntas sobre o estado em tempo real dos dispositivos e o histórico completo, executar agregações e comparações e gerar gráficos inline. Veja [Trabalhar com o Assistente](/kilo-docs-pt/kilo-iot-server/ai-assistant/querying-your-data.md). |
| **Criar e operar** | Aprovisionar dispositivos e gateways (de forma guiada, ou automaticamente quando fornecer as chaves LoRaWAN), criar/testar/implementar regras incluindo o seu CEL, criar alarmes com escalamento, executar comandos em dispositivos após confirmação, configurar dispositivos emulados, gerir funções da equipa e recomendar hardware. Veja [Criar com o Assistente](/kilo-docs-pt/kilo-iot-server/ai-assistant/building-with-ai.md). |
| **Orientar e explicar** | Pesquisar a base de conhecimentos da plataforma e as referências de IoT para explicar funcionalidades, guiá-lo pela configuração e resolver problemas — com base em [o que pode aceder](/kilo-docs-pt/kilo-iot-server/ai-assistant/data-sources.md). |
## Monitorização, automatização e controlo
O assistente trabalha através da plataforma da mesma forma que você: responde com base nos seus dados, cria **monitorização e automatização**, e agora **opera equipamento diretamente** — executando os comandos existentes de um dispositivo após confirmação e reportando se foram entregues. [Construir com IA](/kilo-docs-pt/kilo-iot-server/ai-assistant/building-with-ai.md) explica como isso funciona e quais são os seus limites.
As automatizações também podem agir: uma regra pode executar um comando num dispositivo quando as suas condições forem cumpridas (ver [Executar comandos em dispositivos](/kilo-docs-pt/kilo-iot-server/rules-engine/running-device-commands.md)), pelo que a lógica que define pode tanto notificar as pessoas certas como agir num dispositivo. Para controlo prático, ainda tem o separador **Comandos e estados** do dispositivo e o widget [de controlo](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/control-widget.md).
Também se mantém no seu âmbito da forma que gostaria: funciona apenas dentro do seu acesso e da sua organização atual, nunca entra nos dados de outra organização e nunca expõe credenciais ou segredos de faturação. Veja [Privacidade e segurança](/kilo-docs-pt/kilo-iot-server/ai-assistant/privacy.md).
## Disponibilidade
O assistente faz parte da plataforma, com uma atribuição mensal de pedidos que escala com o seu plano. Se preferir não ficar limitado pela atribuição, pode ligar a sua própria chave de API de modelo e continuar a trabalhar. Verá a sua atribuição restante acima da entrada de chat e um aviso para rever planos ou adicionar uma chave quando a atingir.
As capacidades acima estão ativas hoje e a melhorar continuamente: o assistente funciona numa runtime de agentes de nível empresarial desenvolvida internamente, e a sua precisão cresce à medida que os agentes são treinados em mais trabalho IoT do mundo real — por isso continua a assumir mais tarefas. Essa runtime é [Synthetic Brew](https://syntheticbrew.ai), concebida como um produto em si mesma e não como um chatbot embrulhado na API de outra pessoa.
## Onde ir a seguir
* [Trabalhar com o Assistente](/kilo-docs-pt/kilo-iot-server/ai-assistant/querying-your-data.md) — pergunte sobre os seus dados e obtenha respostas, análises e gráficos
* [Criar com o Assistente](/kilo-docs-pt/kilo-iot-server/ai-assistant/building-with-ai.md) — entregue-lhe trabalho real de configuração: dispositivos, regras, alarmes
* [O que pode aceder](/kilo-docs-pt/kilo-iot-server/ai-assistant/data-sources.md) — as fontes por detrás das suas respostas ancoradas na realidade
* [Privacidade e segurança](/kilo-docs-pt/kilo-iot-server/ai-assistant/privacy.md) — autenticação, isolamento e portas de confirmação
* [Servidor MCP](/kilo-docs-pt/kilo-iot-server/api/mcp-server.md) — ligue o seu próprio cliente de IA, como o Claude Code ou o Claude Desktop, à mesma implementação
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://docs.kiloiot.io/kilo-docs-pt/kilo-iot-server/ai-assistant.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.
