> 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/dashboards/adding-widgets/control-widget/input.md).

# Entrada

Adicione um Controlo de Entrada a um painel IoT Kilo para enviar um valor exato introduzido — um ponto de ajuste ou limiar — com Aplicar.

A **Entrada** é o tipo de controlo de valor exato. O operador introduz um valor preciso e carrega **Aplicar** para o enviar — ideal quando um deslizador é demasiado grosseiro ou o valor tem de ser exato.

## Quando usar

Use uma Entrada quando a precisão importa: uma temperatura ou pressão **limiar**, um **ponto de regulação**, ou um **parâmetro do dispositivo**. Onde um [Slider Simples](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/control-widget/slider-simple.md) serve para definir um valor por sensação, a Entrada serve para introduzir um número exato.

## O que precisa primeiro

* Um dispositivo controlável com um comando no seu **separador Comandos & Estados** separador cujo **parâmetro aceita o valor** que vai introduzir (ver [Criar Comandos](/kilo-docs-pt/kilo-iot-server/devices/commands/creating-commands.md)).
* Um **Métrica do dispositivo** que apresenta o valor atual, mostrado ao lado do campo para referência.

## Como configurá-lo

1. Abra o painel em **modo de edição** → **Adicionar widget** → **Controlo**.
2. **Origem de dados** separador: escolha o **Dispositivo** e o **Métrica do dispositivo** para o valor atual. Clique em **Seguinte**.
3. **Aparência** separador: introduza um **Nome do widget**, depois em **Tipo de widget** escolha **Entrada**.
4. Defina uma **espaço reservado da Entrada** (texto de ajuda no campo) e um opcional **rótulo da Entrada**.
5. Escolha o **Comando** que a entrada envia, o **Parâmetro** que ele define, e um padrão **Valor**.
6. Alternar **Mostrar nome e última atualização**, depois clique em **Salvar**.

<figure><img src="https://585438662-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtNQh1wBSHSaknslMdOXm%2Fuploads%2Fgit-blob-0054c3240c793458b0d9818d62bb969af82df939%2Fcontrol-widget-input.jpg?alt=media" alt="Input Control sending an exact setpoint value with an Apply button"><figcaption></figcaption></figure>

## O que acontece quando o utiliza

O widget mostra o valor atual e um campo. Escreva um novo valor e carregue **Aplicar** para enviar o comando com esse valor como parâmetro — nada é enviado até carregar em Aplicar, por isso um número a meio de escrever nunca chega ao dispositivo. Se um valor é aceite é determinado pela definição do parâmetro do comando (por exemplo, o seu mínimo/máximo), por isso valores fora do intervalo são rejeitados.

## Erros comuns

* **A esperar que seja enviado à medida que escreve** — a Entrada só envia ao carregar em **Aplicar**.
* **Introduzir um valor fora dos limites do parâmetro** — a definição do parâmetro do comando define o intervalo válido; valores fora dele não serão aceites.

## Ver também

* [Widget de controlo](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/control-widget.md) — visão geral e os outros tipos de controlo
* [Comandos do Dispositivo](/kilo-docs-pt/kilo-iot-server/devices/commands.md) — defina o comando que esta entrada define


---

# 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/dashboards/adding-widgets/control-widget/input.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.
