> 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/data-sources.md).

# O Que Pode Aceder

A que o Assistente de IA do Kilo IoT pode aceder — dados de dispositivos em direto, histórico completo de telemetria, conhecimento da plataforma e pesquisa IoT.

As respostas do assistente são fiáveis porque se baseiam na sua implementação real — lidas em tempo real, no momento em que pergunta, e limitadas às suas permissões e à organização atual. Ele vê exatamente o que você vê na interface da plataforma e trabalha com esses dados reais, em vez de conhecimento genérico de treino. Quando algo não pode ser obtido, informa-o em vez de inventar uma resposta.

## Dados dos dispositivos em tempo real

O assistente lê o estado atual de cada dispositivo a que tem acesso: estado online ou offline, carimbo de data/hora da última vez que foi visto, leituras mais recentes dos sensores, nível da bateria, intensidade do sinal, coordenadas GPS, metadados do dispositivo e quaisquer etiquetas que tenha aplicado. Se conseguir ver um dispositivo na página Dispositivos, o assistente pode responder a perguntas sobre ele.

## Registos históricos

Histórico completo de telemetria de qualquer dispositivo ao longo de qualquer período. O assistente suporta agregações (mín., máx., média, soma, contagem), deteção de violações de limiares, filtragem de eventos por tipo ou valor e comparações período a período. A profundidade do histórico disponível depende da janela de retenção de dados configurada no seu plano de subscrição.

## Documentação da plataforma

A base de conhecimentos completa do Kilo IoT Server, pesquisada semanticamente. O assistente interpreta o significado da sua pergunta em vez de corresponder a palavras-chave e, em seguida, devolve explicações relevantes com ligações diretas para páginas de documentação. Isto torna-o uma forma rápida de encontrar respostas sobre funcionalidades, passos de configuração ou melhores práticas sem sair do seu fluxo de trabalho.

## Pesquisa na web sobre IoT

Para questões relacionadas com IoT que estejam fora da documentação da plataforma — especificações de protocolos, fichas técnicas de sensores, melhores práticas do setor, normas de conformidade — o assistente pode pesquisar na web. Esta capacidade é estritamente limitada a tópicos de IoT. Pesquisas web gerais, questões não técnicas e assuntos não relacionados são recusados.

## O que não pode aceder

Os seguintes dados estão fora do alcance do assistente por desenho:

* **Dados de outras organizações.** O isolamento entre inquilinos é absoluto. O assistente não pode atravessar fronteiras organizacionais, mesmo que a sua conta pertença a várias organizações.
* **Dispositivos fora do seu âmbito de permissões.** Se a sua função não conceder acesso a um dispositivo ou localização, o assistente não o pode consultar.
* **Informações de faturação e pagamento.** Os detalhes da subscrição, faturas e métodos de pagamento não são acessíveis através do assistente.
* **Credenciais.** As palavras-passe dos utilizadores, segredos de API e tokens de autenticação nunca são exibidos.
* **Definições apenas de administrador.** A menos que a sua conta tenha permissões de administrador, a configuração ao nível do sistema não é visível.
* **Registos brutos do sistema.** Os registos da infraestrutura interna e as tabelas da base de dados não são expostos.
* **Dados de streaming em tempo real.** O assistente consulta os dados no momento em que pergunta. Não mantém um fluxo em tempo real persistente.


---

# 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/data-sources.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.
