Visão geral
Neste guia, você pode aprender como testar manualmente seu agente do Atlas Agent Engine em um ambiente de desenvolvimento local. Depois de iniciar o ambiente usando o comando agentengine dev, a CLI imprime URLs para o aplicativo e a instância local do MongoDB para que você possa direcionar solicitações, inspecionar respostas e depurar problemas antes de criar e distribuir o agente na nuvem.
Pré-requisitos
Antes de começar, certifique-se de concluir as seguintes tarefas:
Instale e configure a CLI do agente.
Inicie um ambiente de desenvolvimento local seguindo as etapas no guia Executar e testar seu agente localmente.
Para saber mais sobre como instalar a CLI, autenticar e registrar o projeto,consulte Instalar e autenticar.
Acessar serviços locais
Quando você executa agentengine dev up no modo hot-reload ou isolado, a CLI cria a imagem Docker para o agente e inicia a pilha completa. Quando todos os serviços estiverem prontos, a CLI imprime URLs para o aplicativo e a instância MongoDB local.
Use as seguintes URLs para realizar seus testes manuais:
URL do endpoint do aplicativo : use um navegador, cliente API ou ferramentas de linha de comando para enviar solicitações ao seu agente.
URL local do MongoDB Atlas: conecte-se usando
mongoshou outro cliente MongoDB para inspecionar ou semear dados de teste.
Por exemplo, você pode usar essas URLs para realizar os seguintes testes:
Envie um chat ou solicitação HTTP que exerça uma chamada de ferramenta específica.
Insira documentos de teste no banco de dados local e verifique como o agente os utiliza.
Inspecione as respostas quanto à correção, latência e tratamento de erros.
Teste no modo de recarga a quente
O modo de recarga automática monta seu código-fonte no contêiner do aplicativo e recarrega seu processo do agente sempre que você salva uma alteração. Use o seguinte fluxo de trabalho para testar e iterar sem reconstruir a pilha.
Para saber como iniciar o ambiente no modo de recarga automática ou anexar o Código VS ao contêiner em execução, consulte Modo de recarga instantânea (recomendado) no guia Crie seu ambiente local.
Teste no Modo Isolado
Use o modo isolado quando quiser validar o comportamento que depende de limites de serviço, reinicializações de contêineres ou interações de rede.
Para saber como iniciar o ambiente no modo isolado,consulte Modo isolado no guia Crie seu ambiente local.
Aplicar alterações de código.
Como o modo isolado não monta seu código-fonte a partir do host, você deve reconstruir as imagens após as alterações de código. Execute os seguintes comandos para aplicar suas alterações:
agentengine dev stop agentengine dev up --isolated
O primeiro comando interrompe os containers em execução. O segundo reconstrói e reinicia a pilha isolada com seu código atualizado.
Inspecionar registros e solucionar problemas
Enquanto você testa, use comandos agentengine dev para inspecionar registros e redefinir o estado conforme necessário.
Exibir registros
Para transmitir registros de todos os serviços em execução, execute o seguinte comando:
agentengine dev logs
Use essa saída para depurar erros, verificar chamadas de ferramentas e inspecionar mensagens de rastreamento emitidas pelo seu agente.
Redefinir estado local
Se você encontrar erros persistentes relacionados ao conjunto de réplicas ou aos dados locais do MongoDB , poderá redefinir o estado local executando os seguintes comandos:
agentengine dev clean agentengine dev up
Essa sequência remove todos os volumes locais e inicia uma nova pilha.
Aviso
A execução de agentengine dev clean exclui permanentemente todos os dados locais armazenados no volume MongoDB Atlas Local. Faça backup de todos os dados necessários antes de executar este comando.
Próximos passos
Depois de validar seu agente localmente, você pode construí-lo e implementá-lo no ambiente de nuvem do Atlas Agent Engine. Para saber como pacote sua imagem de agente e implantá-la em um espaço de trabalho, consulte a seção Implantar o agente.