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

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 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 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 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 e Autenticação. Para conhecer a ideia geral do produto, leia O que é um computador de IA?.