# De chamadas de ferramentas a um computador para agentes: como a arquitetura muda

Do ciclo de ferramentas a um computador que executa tarefas reais, com ambientes separados, estado salvo, permissões e progresso que você pode consultar.

Canonical page: https://beeuni.ai/blog/pt/from-tool-calls-to-agent-computer

Imagine adicionar ao seu produto um botão para comparar fornecedores. Um cliente seleciona vários orçamentos e pede uma planilha com preços, datas de entrega e diferenças nas condições. Seu primeiro protótipo envia o texto a um modelo. Funciona com um orçamento curto. Então um cliente fornece PDFs digitalizados, uma planilha e um link para o site de um fornecedor.

A função agora precisa abrir arquivos, extrair tabelas, consultar o site, calcular preços comparáveis e criar uma planilha para download. O modelo ajuda a decidir o que fazer. Também precisa de um lugar para executar os programas que fazem isso. É aí que um computador para agentes se torna útil.

## O que acontece depois que o modelo pede para executar um comando?

Uma chamada de ferramenta é um pedido do modelo ao seu programa. Por exemplo, o modelo pode pedir a execução de um script que lê os orçamentos. Seu programa ainda precisa fornecer os arquivos, instalar o programa de extração, executar o script e retornar a saída. Se a extração falhar em uma página digitalizada, o agente precisa examinar o erro e tentar outro método disponível.

Você pode construir essas etapas por conta própria. Conforme a função cresce, também precisa de um navegador, acesso a arquivos, saídas de comandos e uma forma de separar o trabalho dos clientes. O Beeuni reúne esses elementos em uma sessão: o agente trabalha em um computador na nuvem onde pode ler arquivos, escrever código, executar comandos e usar o navegador.

Para a comparação, o agente pode salvar as linhas extraídas, escrever um script de cálculo e executá-lo. Pode visitar uma página pública do fornecedor para verificar uma condição de entrega. Se uma linha não tiver unidade ou data claras, o resultado pode sinalizar essa dúvida para revisão. O cliente recebe uma planilha que pode conferir, com referências às fontes.

## Do ciclo de chamadas de ferramentas ao trabalho em um computador

O ciclo de ferramentas continua orientando o raciocínio: consultar o modelo, executar a ação solicitada, retornar o que aconteceu e consultar de novo. Para o PDF, o computador executa um script de extração e retorna código de saída, saída e erros. O agente lê esses resultados antes de decidir o próximo passo. Uma falha na extração, uma tabela vazia e uma extração bem-sucedida exigem ações diferentes.

Guarde o PDF original, extracted.csv, o script de cálculo e a planilha final em arquivos separados. Se os números parecerem errados, você pode rastreá-los por esses arquivos. Peça ao agente para comparar uma linha extraída com a página original antes de mudar o cálculo. Assim, dá para corrigir a etapa em que a informação se perdeu.

Uma ferramenta também pode iniciar um processo que dure mais do que a própria chamada. Uma conversão de documentos pode continuar em execução quando a requisição esgota o tempo de espera. A camada de execução precisa permitir a consulta desse processo e de sua saída. Pedir ao modelo para iniciá-lo novamente pode criar duas conversões em vez de resolver o atraso.

## Dê a cada tarefa um ambiente de trabalho separado

Quando duas comparações compartilham um diretório, qualquer uma pode sobrescrever extracted.csv ou instalar uma versão de pacote incompatível com a outra. Cada sessão do Beeuni tem seu próprio ambiente de execução, que separa esses arquivos e processos locais. Para trabalhos em repositórios, a branch da sessão também permite revisar as mudanças antes de aceitá-las na branch padrão.

Aplicativos compartilhados precisam de atenção separada. Se ambas as sessões podem atualizar o mesmo registro de compras, computadores diferentes não impedem edições conflitantes nesse aplicativo. Decida se a comparação apenas lê esses registros ou se uma atualização precisa de aprovação.

## Decida o que deve permanecer após uma parada ou falha

A sessão salva mostra o que o agente fez. O disco contém os arquivos extraídos e a planilha. Um processo em execução contém trabalho ainda não gravado. São estados diferentes: recuperar as mensagens não significa que uma conversão retome a partir da instrução em que parou.

Uma parada normal preserva o disco do computador. Excluir ou perder o computador exige outro caminho de recuperação, usando a conversa salva e o trabalho no repositório quando disponíveis. Salve resultados importantes no seu armazenamento e envie ao repositório as mudanças que precisa manter. O [guia de sessões](/docs/pt/work/sessions) explica o que cada operação preserva.

## Defina permissões para as ações importantes

O agente de comparação pode precisar ler documentos de fornecedores, enquanto fazer um pedido exige uma decisão humana. As [políticas de conectores](/docs/pt/connect/connectors) do Beeuni podem permitir uma ação, exigir aprovação ou bloqueá-la. Configure a própria ação, em vez de depender apenas de uma frase na tarefa. Um computador pode isolar o trabalho local, mas suas ferramentas conectadas ainda afetam um sistema de compras real.

Seu produto também verifica qual cliente pode abrir cada comparação e seus arquivos. Uma chave API mantida no servidor autentica o aplicativo no Beeuni. Seus próprios controles de acesso vinculam essa requisição à pessoa autorizada a ver o resultado.

## Deixe tarefas longas continuarem além de uma conexão

O cliente pode fechar a página enquanto uma conversão está rodando. Salve o ID da sessão do Beeuni junto ao registro da comparação para reencontrar o mesmo trabalho quando ele voltar. Os fluxos de eventos mostram o progresso ao vivo; os logs salvos permitem consultar depois o que aconteceu. Um computador acessível pode estar ocupado, ter terminado ou aguardar uma resposta. Mostre o estado da tarefa além da disponibilidade do computador.

Antes de repetir uma requisição interrompida, verifique o que aconteceu. Isso é especialmente importante para ações externas: um pedido pode ter sido criado mesmo sem a confirmação chegar. O [guia de backend para agentes](/blog/pt/use-beeuni-as-your-agent-backend) explica os registros que seu aplicativo deve manter e como tratar reconexões.

## Facilite a investigação das falhas

Suponha que a planilha gerada tenha a coluna de preços vazia. Abra os arquivos e as saídas dos comandos da sessão. A extração do PDF não retornou linhas? O script esperava uma coluna «Price», mas o orçamento usava «Unit cost»? A página do fornecedor exigia login? Cada causa pede uma correção diferente.

Como o agente trabalha com arquivos e programas, você pode pedir que ele examine um CSV intermediário, corrija a correspondência entre colunas e refaça o cálculo. Isso costuma ser mais útil do que pedir outra resposta final ao modelo sem saber o que falhou.

## Melhore a etapa cuja lentidão você consegue observar

Essa função pode gastar tempo preparando o computador, esperando o modelo, extraindo documentos e carregando sites. Observe uma comparação real antes de mudar a arquitetura. Se o agente abre o mesmo PDF repetidamente, salve o texto extraído e trabalhe a partir dele. Se um script de cálculo for lento, examine o script. Se o site do fornecedor for lento, trocar o modelo não fará a página carregar mais rápido.

Confira a planilha depois de cada mudança. Uma extração mais rápida só ajuda se continuar capturando preços e condições corretamente. Compare os mesmos documentos com as mesmas configurações do modelo para ver se a mudança ajudou.

## O que a arquitetura passa a fornecer

O modelo continua escolhendo ações em um ciclo de ferramentas. Ao redor dele, o serviço agora executa programas, separa tarefas, mantém trabalho útil, aplica permissões e mostra o progresso. Essa é a mudança de arquitetura por trás de um computador para agentes. O Beeuni fornece essas interfaces de execução e sessão para seu aplicativo enviar uma tarefa e acompanhar o trabalho enquanto ele acontece.

A mesma abordagem pode servir para preparar conjuntos de dados ou testar um site com o navegador. Os arquivos, comandos e resultados esperados mudam. Seu produto continua iniciando uma sessão, acompanhando o trabalho e apresentando um resultado que o cliente pode usar.

Comece por [Sessões pelo código](/docs/pt/sdk/sessions) e [Autenticação](/docs/pt/sdk/auth). Para conhecer a ideia geral do produto, leia [O que é um computador de IA?](/blog/pt/what-is-an-ai-computer).