> 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/getting-started/let-ai-set-it-up.md).

# Deixe a IA Configurá-lo por Si

Não tem de configurar o Kilo manualmente. Peça ao assistente de IA integrado ou ligue o cliente de IA que já usa via MCP, e ele faz a configuração consigo.

A maioria das plataformas IoT começa com um ecrã vazio e um formulário extenso. O Kilo não exige isso. **Pode descrever o que quer em linguagem simples e deixar a IA fazer o trabalho mecânico** — registar dispositivos, escrever a automatização, configurar os alarmes — enquanto mantém o controlo de aprovação sobre tudo o que seja consequente.

Esta página é deliberadamente a primeira coisa nesta secção, porque o passo a passo manual que se segue não é a única forma de começar e, para a maioria das pessoas, não é a mais rápida.

Também não precisa de hardware para começar. O [Conector do Emulador](/kilo-docs-pt/kilo-iot-server/connectors/emulator-connector.md) cria dispositivos que geram a sua própria telemetria a partir de predefinições de dispositivos reais, para que possa construir e testar uma implementação completa — painéis, regras, alarmes escalonados — antes de chegar qualquer coisa, e depois apontar esses mesmos dispositivos para sensores reais no dia em que isso acontecer.

## Duas formas de deixar a IA fazer o trabalho

Existem dois caminhos, e são realmente diferentes. Escolha um ou use ambos.

|                                         | **Assistente de IA integrado**                                                                                                                                                                                                                                                                                     | **O seu próprio cliente de IA (MCP)**                                                                                                                                                                                                                                                                                          |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Onde é executado                        | Dentro do Kilo, em **Chat de IA** na barra lateral                                                                                                                                                                                                                                                                 | Na aplicação que já usa — Claude Code, Claude Desktop, ChatGPT, Codex, Cursor                                                                                                                                                                                                                                                  |
| Configuração necessária                 | Nenhuma. Faz parte da plataforma                                                                                                                                                                                                                                                                                   | Ligue-se uma vez através de [MCP](/kilo-docs-pt/kilo-iot-server/api/mcp-server.md) e inicie sessão com a sua conta normal do Kilo                                                                                                                                                                                              |
| O que pode fazer                        | Responder com base em telemetria em tempo real e histórica, aprovisionar dispositivos e gateways, criar, testar e implementar regras incluindo o respetivo CEL, criar alarmes com escalonamento, executar comandos em dispositivos, configurar dispositivos emulados, gerir funções da equipa, recomendar hardware | As mesmas operações, expostas como ferramentas MCP, sobre a mesma implementação                                                                                                                                                                                                                                                |
| Permissões                              | Herda exatamente as suas permissões e organização                                                                                                                                                                                                                                                                  | Idêntico — a ligação transporta as permissões da sua própria conta                                                                                                                                                                                                                                                             |
| Confirmação antes de ações consequentes | **Imposto pelo assistente.** Ações destrutivas ou difíceis de reverter apresentam um **Confirmar ação** / **Cancelar** e não prosseguem até que as aprove                                                                                                                                                          | **Depende do seu cliente.** O Kilo assinala ferramentas destrutivas com as anotações MCP padrão e indica o requisito na descrição da ferramenta; os clientes compatíveis mostram um pedido de aprovação. As anotações são sugestões para a aplicação anfitriã, não algo que o Kilo possa impor dentro de software de terceiros |
| Ideal para                              | Configurar tudo, operação do dia a dia, qualquer pessoa que queira que a plataforma a guie                                                                                                                                                                                                                         | Trabalhar com as suas próprias ferramentas, scriptar, ou manter-se no editor que já tem aberto                                                                                                                                                                                                                                 |

A linha de confirmação é a única diferença real e vale a pena lê-la duas vezes. Dentro do Kilo, o controlo é nosso e funciona. Através de um cliente externo, o controlo pertence a esse cliente.

O que é imposto em **ambos** os casos: a ligação só pode ler e alterar o que as suas próprias permissões permitem, permanece na sua organização atual, um comando de dispositivo tem de existir previamente nesse dispositivo antes de poder ser executado, e cada envio é registado.

## Rota 1 — o assistente integrado

Abre **Chat de IA** na barra lateral e descreva o que quer. Ele já conhece a sua implementação, por isso pode ser direto:

* *"Registe este sensor LoRaWAN — aqui estão o DevEUI e a AppKey."*
* *"Alerta a equipa de instalações de prevenção se qualquer câmara frigorífica ultrapassar 8 °C durante mais de 20 minutos."*
* *"Crie um dispositivo de teste que se comporte como um sensor de distância Dragino para que eu possa construir o painel agora."*

Mostrar-lhe-á o que está prestes a alterar e aguardará a sua aprovação antes de acontecer qualquer coisa importante. Veja [Construir com o assistente](/kilo-docs-pt/kilo-iot-server/ai-assistant/building-with-ai.md) para ver o que pode fazer e quais são os seus limites.

<figure><img src="https://585438662-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtNQh1wBSHSaknslMdOXm%2Fuploads%2Fgit-blob-5d360ebd1f4608addcd5f475e2028ac895951211%2Fai-chat-home.jpg?alt=media" alt="The Kilo IoT AI assistant ready to help set up automations, devices, and alerts"><figcaption><p>O assistente integrado, pronto para fazer o trabalho de configuração consigo</p></figcaption></figure>

## Rota 2 — ligue o cliente de IA que já utiliza

Se já trabalha no Claude, ChatGPT, Cursor ou Codex, aponte-o para a sua organização Kilo através do MCP e ele pode operar a mesma implementação a partir daí. Inicie sessão através do navegador com a sua conta normal — não há nenhuma chave de API para gerar ou colar.

<figure><img src="https://585438662-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtNQh1wBSHSaknslMdOXm%2Fuploads%2Fgit-blob-c76dbc8c4ecd947cc8440377d59be70c5367d640%2Fmcp-claude-session.jpg?alt=media" alt="A Claude Code session connected to Kilo over MCP, calling a real tool and asking for permission before continuing"><figcaption><p>Uma sessão autenticada do Claude Code a descobrir uma ligação LoRaWAN numa implementação em produção e a pedir permissão antes de continuar</p></figcaption></figure>

As instruções de configuração para cada cliente estão em [Servidor MCP](/kilo-docs-pt/kilo-iot-server/api/mcp-server.md).

## Quando o fazer manualmente em vez disso

Fazê-lo manualmente continua a valer o seu tempo quando quer perceber a mecânica, quando está a depurar algo específico ou quando simplesmente prefere os formulários. Nada lhe é escondido: tudo o que a IA faz é uma ação normal da plataforma que também poderia ter executado você mesmo, e aparece nos mesmos sítios.

[Navegar na interface](/kilo-docs-pt/kilo-iot-server/getting-started/navigating-the-interface.md) faz uma visita guiada à plataforma, e [A sua primeira implementação](/kilo-docs-pt/kilo-iot-server/getting-started/your-first-deployment.md) percorre o caminho completo do LoRaWAN, do gateway ao painel em direto.


---

# 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/getting-started/let-ai-set-it-up.md?ask=<question>&goal=<endgoal>
```

`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.
