> For AI agents: the complete documentation index is available at https://developers.orbita.nexxo.tec.br/llms.txt, the full documentation bundle is available at https://developers.orbita.nexxo.tec.br/llms-full.txt.

# Ferramentas e aprovação

## Mostre o que será executado

Uma interface de ferramentas deve separar argumentos, prévia, decisão da pessoa e resultado da API. Use uma apresentação expansível para os detalhes e mantenha a decisão em um controle explícito.

A demonstração abaixo usa os padrões **Tool** e **Confirmation** de AI Elements, compostos com `Trace`, `Item` e `Button` de shadcn/ui. O payload é ilustrativo e não é enviado ao MCP.

## Conecte a decisão ao contrato correto

Na integração real, o aceite do usuário permite enviar o commit com o token da prévia. O servidor ainda precisa validar usuário, organização, operação e payload. Mostre “executado” somente depois da resposta de sucesso da ferramenta.

Para o contrato do serviço, consulte [prévias e confirmações](https://developers.orbita.nexxo.tec.br/mcp/confirmacoes.md). Para a composição dos componentes, consulte [interfaces de desenvolvedor](https://developers.orbita.nexxo.tec.br/ia/interfaces.md).
