Controle de versão para agentes de IA e fluxos de trabalho do agente

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • O controle de versão permite que você rastreie mudanças feitas nas instruções enviadas para o LLM para agentes de IA e fluxos de trabalho do agente.

    Visão geral do controle de versão

    Ao criar um agente de IA ou um fluxo de trabalho do agente de IA, o List of stepsO campo é importante porque fornece o contexto necessário para que o modelo de linguagem grande (LLM) execute tarefas. Você pode usar o controle de versão para criar várias versões do List of stepscampo na configuração assistida. Acompanhar suas mudanças com o controle de versão ajuda a permitir que você experimente e teste novas instruções. Você pode criar versões, editar e refinar versões e reverter para versões anteriores conforme necessário.

    Figura 1. Modal de controle de versão
    Modal de controle de versão da configuração assistida de um agente de IA com várias versões exibidas

    Criando versões

    Você pode criar uma versão selecionando Visualizar versões > Nova versão Na configuração assistida de um agente de IA ou fluxo de trabalho do agente de IA. Fazer isso traz Create a new versionmodal em que você pode nomear a versão e fazer mudanças. Nomear sua versão permite que você identifique quais mudanças foram feitas para facilitar o acompanhamento.

    Você pode optar por ativar a nova versão imediatamente selecionando Definido como ativo alternar.

    Para obter mais informações sobre como escrever descrições e instruções eficazes, consulte Diretrizes gerais para criar agentes de IA e fluxos de trabalho do agente .

    Ao criar uma nova versão, você também tem a opção de usar Now Assist para refinar seu atual List of steps. Você já deve ter uma versão ativa para que esta opção esteja disponível. Selecionando Visualizar versões > Refinar versão abre o modal onde Now Assist gera e exibe um novo List of stepspara você revisar. Você pode mudar qualquer texto gerado ou usá-lo como ele foi gerado. Selecione Criar para usar a nova versão refinada.

    Figura 2. Criar um novo modal de versão
    Criar um novo modal de versão

    Alterando entre versões

    Quando você tem várias versões do mesmo List of steps, você pode alternar qual está ativo a qualquer momento. Optar por ativar uma nova versão permite testá-la e avaliar sua eficácia.

    Se você estiver atualizando um fluxo de trabalho do agente, poderá execute uma execução de avaliação do agente para medir o desempenho.

    Você pode decidir qual versão está ativa selecionando Exibir versões na configuração assistida. Alterne Definido como ativo e salve suas mudanças para ativar a nova versão.

    Testando diferentes versões

    Você pode testar diferentes versões de um fluxo de trabalho do agente do agente do agente de IA do Estúdio de agentes de IA Teste página. . Versão o menu suspenso do seletor exibe as versões ativas e inativas com a versão ativa no momento marcada como (Active). Você também pode iniciar execuções de avaliação para versões específicas selecionando Configurar execução de avaliação .

    Figura 3. Seletor de versão no Estúdio de agentes de IA Página de teste
    Página de teste no AI Agent Studio com um fluxo de trabalho e uma versão selecionadas

    Logs de versão

    . Estúdio de agentes de IA Atividade A página permite que você rastreie execuções de agentes de IA e fluxos de trabalho de agentes por versão. Na configuração assistida, você pode selecionar Exibir logs de versão em View all versionsmodal. Optar por exibir os logs de versão abre o. Atividade em uma nova janela com a lista filtrada para a versão selecionada.

    Ao exibir o. Atividade a qualquer momento, você pode optar por filtrar por versão. Quanto mais específicos forem os nomes das versões, mais fácil será identificar essas mudanças na lista.

    Figura 4. Logs de execução de exemplo
    Página de atividades do AI Agent Studio com a coluna Versões realçada