Assistente de IA

O assistente de IA é um widget no canto inferior direito do painel de administração. Em sua forma minimizada, é um botão esférico; um clique nele abre o painel do assistente. Enquanto o assistente está em funcionamento, a esfera pulsa — assim é possível ver que o agente ainda está executando a tarefa, mesmo que o painel esteja fechado.

No painel, há duas abas (na interface em português — "Documentação" e "Agente MCP"):

Aba	O que faz
documentação	responde a perguntas sobre a documentação do OneEntry — não altera nada no projeto
Agente MCP	executa a tarefa descrita em palavras comuns: encontra a operação necessária da Admin API, cria e altera dados do projeto

As abas têm histórias separadas: perguntas à documentação não entram na conversa com o agente, e vice-versa.

O uso do agente tem custo

Cada execução do agente consome recursos da conta de IA selecionada no painel: o agente consulta o modelo várias vezes para uma única tarefa — busca a operação, analisa-a, a chama, verifica o resultado. O custo de cada execução é exibido abaixo da resposta, e o saldo total — na aba Configurações → Agentes de IA.

Painel do assistente

No cabeçalho do painel, à direita das abas, há três botões:

• expandir / recolher — amplia o painel ou retorna ao tamanho normal;
• limpar histórico — limpa a conversa da aba aberta. O botão fica inativo enquanto não houver nada na conversa ou enquanto o assistente ainda estiver respondendo;
• fechar — recolhe o painel de volta para a esfera. O painel também pode ser fechado com um clique em qualquer lugar fora dele.

Aba do Agente MCP

O agente executa a tarefa descrita em suas próprias palavras — por exemplo, "crie uma página sobre entrega" ou "crie produtos a partir desta tabela". Ele trabalha com a Admin API através de um conjunto de ferramentas: busca a operação necessária, analisa seus parâmetros, a chama, carrega arquivos. Entre as ferramentas, há também uma busca na documentação do OneEntry — o agente lê a documentação por conta própria, se precisar entender como o módulo funciona.

Os direitos do agente são os seus direitos

O agente atua em nome do administrador atual e com seus direitos: o que não está disponível para você, também não está disponível para o agente. A exclusão de dados é proibida para o agente, e operações protegidas são realizadas apenas após sua confirmação (veja abaixo).

Seleção do agente e do modelo

Na parte superior da aba, nos campos Agente e Modelo, são selecionados a conta de IA e o modelo que executarão a tarefa. As contas são retiradas de Configurações → Agentes de IA. Na lista, estão apenas os modelos que podem chamar ferramentas: sem isso, o agente não pode trabalhar com a API.

Se não houver nenhuma conta de IA no projeto, em vez de uma seleção, o painel mostrará um aviso de que o agente de IA não está configurado e precisa ser criado nas configurações. Crie uma conta na aba Configurações → Agentes de IA.

Execução da tarefa

1. Descreva a tarefa no campo de solicitação.
2. Se necessário, anexe um arquivo usando o botão de clipe — por exemplo, uma tabela com produtos. Apenas um arquivo pode ser anexado à solicitação. Os tipos de arquivos permitidos e o tamanho máximo são definidos pelo servidor; um arquivo muito grande não será aceito pelo painel e será sugerido que você o divida em partes. Uma imagem só pode ser anexada se o modelo selecionado conseguir ler imagens — caso contrário, escolha outro modelo ou anexe um documento.
3. Clique no botão de execução (na interface em português — "Executar"). Enquanto o agente está trabalhando, o botão é substituído pelo botão de cancelamento ("Cancelar") — que interrompe a execução.

Enquanto a tarefa está em execução, os passos do agente são visíveis no feed: qual operação ele está buscando, qual ele está chamando, qual arquivo ele está carregando. Um passo com detalhes pode ser expandido com um clique. Quando o agente terminar, sua resposta aparecerá abaixo dos passos, e abaixo da resposta estará o custo da execução: número de tokens e custo em dólares.

O agente considera as últimas trocas concluídas na conversa, portanto, a próxima tarefa pode ser formulada como uma continuação da anterior.

Confirmação de operações protegidas

Antes de uma operação protegida, o agente para e exibe um cartão com um pedido de permissão. Nele estão o método e o endereço da solicitação, os dados que serão enviados e o que atualmente está nesse endereço. A decisão é tomada com base na própria solicitação, e não em um resumo do modelo:

• botão de permissão (na interface em português — "Permitir") — o agente executa a operação;
• botão de recusa ("Recusar") — a operação não é executada.

Se a resposta não chegar ao servidor, o cartão informará sobre isso, e os botões voltarão a estar disponíveis.

O que é importante saber

• Fechar o painel não cancela a tarefa. O agente continua trabalhando, os passos e a resposta aparecerão quando o painel for reaberto. Mas após fechar o painel ou mudar de aba, não é possível interromper uma tarefa já iniciada a partir do painel, e o texto não enviado da solicitação e o arquivo anexado serão perdidos.
• O histórico é armazenado apenas na memória da página. Após recarregar a página, a conversa com o agente desaparece. Fechar a aba do navegador ou recarregar durante o trabalho do agente interrompe a tarefa.
• Se o limite da conta de IA for atingido ou se o modelo selecionado não for adequado, a tarefa não será iniciada — o painel mostrará o motivo.