> 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/querying-your-data.md).
# Trabalhar com o Assistente
Consulte o Kilo IoT Server em linguagem natural — estado do dispositivo, histórico, violações de limiar, seguimentos.
O Assistente de IA aceita linguagem natural. Não há sintaxe especial para aprender, nem linguagem de consulta para memorizar. Escreva como falaria com um colega que, por acaso, sabe tudo sobre a sua implementação — seja você *a perguntar* sobre os seus dados ou *pedindo-lhe para fazer alguma coisa*. Esta página foca-se no lado de perguntar e analisar; para lhe atribuir trabalho real de configuração, consulte [Construir com o Assistente](/kilo-docs-pt/kilo-iot-server/ai-assistant/building-with-ai.md).
Quando abrir **Chat de IA**, uma saudação e alguns tópicos sugeridos ajudam-no a começar — selecione um, ou simplesmente escreva a sua pergunta na caixa na parte inferior.
## Escrever consultas eficazes
Uma pergunta específica produz uma resposta específica. Siga estas orientações para obter os resultados mais úteis:
* **Indique o dispositivo, sensor ou localização.** "Qual é a temperatura no Armazém B?" é muito mais útil do que "Qual é a temperatura?" Quando dezenas de sensores reportam temperatura, o assistente precisa de saber a qual se refere.
* **Use expressões temporais naturais.** O assistente entende "ontem", "últimas 3 horas", "entre 1 de janeiro e 15 de janeiro", "esta manhã" e expressões semelhantes. Não é necessário fornecer timestamps Unix ou datas formatadas.
* **Faça perguntas de seguimento.** O assistente mantém o contexto completo dentro de uma conversa. Refine, restrinja ou amplie uma consulta anterior sem repetir tudo.
* **Reutilize a sua última mensagem.** Prima a **tecla de seta para cima** na entrada de chat para recuperar a última mensagem que enviou — útil para ajustar uma pergunta e voltar a fazê-la.
## Categorias de consultas
### Estado em tempo real
Pergunte sobre o estado atual dos seus dispositivos:
* "Quais dispositivos estão offline?"
* "Qual é a humidade atual na Sala de Servidores 3?"
* "Mostre-me todos os dispositivos com bateria abaixo de 20%"
* "A gateway do telhado está online?"
### Dados históricos
Consulte registos de telemetria em qualquer período de tempo abrangido pelas suas definições de retenção:
* "Qual foi a temperatura média no Armazém Frio A na semana passada?"
* "Quando foi a última vez que o Congelador 3 ultrapassou os -18 graus Celsius?"
* "Quantos eventos de abertura de porta ocorreram depois das 22h este mês?"
* "Mostre-me todas as leituras de CO2 acima de 1000 ppm nas últimas 48 horas"
### Agregações e comparações
Realize cálculos entre dispositivos, intervalos de tempo ou ambos:
* "Compare as leituras de temperatura desta semana no Armazém B com as da semana passada"
* "Qual foi o nível máximo de CO2 no laboratório hoje?"
* "Que zona teve a humidade média mais elevada em março?"
### Gráficos
Solicite gráficos visuais e eles serão apresentados inline na janela de chat:
* "Crie um gráfico de linhas da temperatura do Sensor 5 ao longo dos últimos 7 dias"
* "Mostre um gráfico de barras comparando a humidade em todos os sensores do armazém"
* "Gráfico circular do estado dos dispositivos em toda a frota"
* "Gráfico de dispersão da temperatura versus humidade para o Laboratório 1 esta semana"
Gráficos de linhas funcionam melhor para tendências de séries temporais, gráficos de barras para comparações entre dispositivos ou entre períodos, gráficos circulares para repartições proporcionais e gráficos de dispersão para identificar correlações entre duas medições.
### Documentação
Pergunte sobre qualquer funcionalidade da plataforma e o assistente pesquisa semanticamente toda a base de conhecimento:
* "Como configuro uma gateway LoRaWAN?"
* "Explique o histórico de versões do motor de regras"
* "Que canais de notificação estão disponíveis?"
As respostas incluem explicações e links diretos para as páginas de documentação relevantes.
## Conversas em vários passos
O assistente lembra-se do contexto dentro de uma sessão. Desenvolva as respostas anteriores sem se repetir:
1. "Mostre-me leituras de temperatura do Sensor 5 ao longo da última semana"
2. "Agora expanda isso para o último mês"
3. "Compare isso com o Sensor 6 no mesmo período"
4. "Qual deles teve mais violações de limite acima de 30 graus?"
Cada pergunta de seguimento constrói sobre o contexto anterior, tornando a análise complexa conversacional em vez de tediosa.
## De perguntar a agir
A mesma conversa pode passar da análise diretamente para a ação. Depois de "quais congeladores ultrapassaram −18 °C na noite passada?", pode seguir com "crie uma regra que me alerte se isso acontecer novamente" — e o assistente cria-a e implementa-a. Sempre que um pedido alteraria algo com consequências, o assistente mostra uma confirmação com **Confirmar ação** e **Cancelar** primeiro, para que mantenha o controlo de cada alteração. O fluxo de trabalho completo de criação e operação é abordado em [Construir com o Assistente](/kilo-docs-pt/kilo-iot-server/ai-assistant/building-with-ai.md).
---
# 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/querying-your-data.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.
