Ir para a atividade

Tecnologias Emergentes · ESOFT8

Laboratório de processo com agentes

Ajuste as instruções dos agentes no Dify e veja o que muda no código e nos testes.

A8 · Individual · 15/10/2026 · Entrega até o fim do encontro

0,5ponto

O que você vai investigar

Regras do projeto, decisões dos agentes

Você vai trabalhar com três agentes de IA já montados no Dify. Cada um tem uma tarefa:

Seu cenário traz regras de uma equipe. Você vai decidir o que acrescentar às instruções de cada agente e quais materiais ele precisa receber.

Primeiro, execute tudo como está. Depois, faça as alterações e execute de novo. O verificador desta página testa o resultado e mostra o que passou e o que falhou.

Seu projeto

1. Seu cenário

Digite seu RA. A página escolhe o cenário pelo último número antes do hífen. Por exemplo, o RA 23182969-2 usa o número 9 e recebe o cenário 2.

Digite o RA para ver o cenário.

Preparação · 15 min

2. Preparar o Dify

O Dify organiza os agentes em um fluxo, chamado workflow. Cada bloco desse fluxo é um nó. Você vai importar um arquivo com os blocos já montados.

  1. Abra cloud.dify.ai e entre com GitHub ou Google. O plano Sandbox é gratuito e não pede cartão.
  2. Baixe o arquivo do fluxo: a8-spec-coder-tester.yml.
  3. No Studio, clique em Importar DSL (Import DSL file) e selecione o arquivo baixado. DSL é o nome que o Dify usa para esse arquivo de configuração.
  4. Se aparecer um pedido para instalar o plugin OpenAI, instale. Esse complemento permite usar o modelo no Dify.
  5. Clique em cada bloco dos agentes spec, coder e tester. Confira se o modelo escolhido é gpt-4o-mini. O modelo é a IA que responde ao agente. Ele usa os créditos gratuitos do Dify.
  6. Confira os blocos na imagem abaixo. Depois do spec, os blocos Ler especificação e Tem dúvidas? conferem se ele deixou perguntas. Se houver dúvidas, o fluxo para. Caso contrário, tester e coder recebem a descrição do spec, chamada especificação. O bloco Montar entrega reúne as respostas.
Opcional: ativar o plano de estudante

O tutorial Dify for Education explica como verificar o e-mail institucional e ativar um ano com desconto. Ele inclui o uso de cartão virtual exclusivo e o cancelamento da renovação. Você pode fazer esta atividade só com o plano gratuito.

Você não precisa criar conta na OpenAI nem cadastrar uma chave de API. Uma execução completa faz três consultas à IA e usa os créditos do Dify. Se faltar crédito ou houver problema de acesso, use a reserva com chat e registre o problema no formulário. Isso não reduz sua nota.

Workflow importado no Dify com os nós spec, coder e tester
Workflow depois da importação.

Primeira execução · 15 min

3. Fazer a primeira execução

Essa primeira execução é a linha de base. Ela serve para comparar o resultado antes e depois das suas alterações. Mantenha as instruções originais dos agentes.

No Dify, clique em Executar (Run). Copie os textos abaixo para os campos Pedido e Respostas às dúvidas:

Pedido

  
Respostas às dúvidas

  
Deixe material_1 e material_2 vazios nessa primeira execução. Os materiais do cenário entram só na próxima etapa.

  
Quando terminar, abra a aba RESULT do painel de execução e use o botão de copiar. Cole o resultado inteiro no verificador e selecione a rodada antes. Confira qual regra do cenário falhou.

  
Se o fluxo parar em Parar com dúvidas, leia as perguntas do agente. Acrescente suas respostas no fim do campo Respostas e execute de novo. Responda como a pessoa que pediu o código, mantendo o pedido original.

  
Execução que parou no nó Parar com dúvidas
Execução que parou com dúvidas. A dúvida aparece no início do resultado.

  
Resultado da execução no Dify com o campo entrega
Campo entrega no resultado da execução.






  
Alteração e comparação · 35 min

  
4. Ajustar as instruções dos agentes

  
Leia as regras do cenário e decida como cada uma chega ao agente. Você pode mudar uma instrução ou acrescentar um material ao que ele recebe.

  

    
LocalUse quandoComo fazer no Dify

    
      
Instrução do agenteO agente precisa agir de outro jeitoClique no bloco do agente e edite System, o campo de instruções

      
Material recebido pelo agenteO agente precisa de um dado do projeto que hoje não recebePreencha material_1 ou material_2 e inclua esse campo em User, no bloco do agente. Veja os passos abaixo

      
Nada a alterarO verificador já executa a regraRegistre no formulário qual verificação já confere essa regra

    
  

  
Como fazer o agente receber um material

  
    
    
  1. Copie o material do seu cenário para o campo indicado, material_1 ou material_2, ao executar.
    2. 
    
  2. Clique no bloco do agente que precisa ler esse material e encontre User.
    3. 
    
  3. Digite { ou / no editor e selecione o campo do material. O botão {x} também mostra os campos disponíveis.
    4. 
  

  
Esses campos são as variáveis do fluxo. Preencher um material na entrada não faz todos os agentes receberem esse texto. Cada agente lê apenas o que foi incluído nas suas instruções.

  
Mantenha o tester sem acesso ao código do coder. Ele deve criar os testes a partir da especificação.

  
Faça até três execuções após as alterações. Registre-as como depois, depois-2 e depois-3. Se alguma regra ou teste falhar, leia o motivo no verificador e ajuste a instrução antes de tentar de novo.

  
Antes de executar de novo, guarde o trecho original e o trecho que você alterou. Você vai precisar dos dois no formulário.

  
Painel do nó spec com os prompts System e User
Clique no bloco do agente. Edite as instruções em SYSTEM e inclua os materiais em USER.






  
Execução no navegador

  
Verificador

  
O Dify gera as respostas dos agentes. Este verificador executa o código e os testes no seu navegador.

  
    
    
  1. Cole abaixo o resultado copiado do Dify, que contém o campo entrega. Você não precisa editar esse texto.
    2. 
    
  2. Escolha a rodada. Use antes na primeira execução e depois na primeira tentativa com alterações.
    3. 
    
  3. Confira onde executou e qual modelo usou. Clique em Verificar e registrar a rodada.
    4. 
  

  
Como ler o resultado
    
Os casos do tester são os cinco testes escritos pelo agente. Eles conferem se o código cumpre a especificação. Essa é a verificação.

    
A suíte de referência é um conjunto de sete testes preparados a partir do pedido original. Os agentes não veem esses testes. Eles conferem se o código atende ao pedido. Essa é a validação.

    
O gate é a checagem das regras do seu cenário, como o limite de linhas alteradas. Ele sempre dá o mesmo resultado para a mesma entrada. Já o agente pode responder de outro jeito a cada execução.

    
Se aparecer "falso negativo", o tester deixou passar um problema que os testes de referência encontraram.

    
Ao conferir cada teste, o verificador exige os IDs na ordem esperada e as tarefas com seus valores originais. A lista recebida pelo código também precisa continuar intacta.

    
O código roda em um Web Worker, uma execução separada dentro do navegador. Cada conjunto de testes tem um limite de cinco segundos.

  

  

    
    
    
  

  
  
  






  
Registro e análise · 15 min

  
5. Registrar e entregar

  
RA, entrega colada, opções do verificador, resultado da última checagem, reserva com chat e rodadas ficam salvos neste navegador. As rodadas são separadas por RA. Se verificar outra resposta com o mesmo nome de rodada, ela substitui o registro anterior. Recarregar a página ou fechar a aba não apaga esses dados.

  

  

    
    
  

  
Entrega

  
    
    
  1. No Studio, abra o menu do seu app e clique em Exportar DSL. Esse arquivo guarda o fluxo com suas alterações.
    2. 
    
  2. Envie o arquivo para o Google Drive e libere acesso de leitura para pedro.satin@unicesumar.edu.br.
    3. 
    
  3. Clique em Copiar registro para o formulário, acima desta lista.
    4. 
    
  4. Abra o formulário da sua turma pelo link enviado pelo professor. Cole o registro, o link do arquivo e os trechos que alterou. Responda às perguntas de análise com base no que aconteceu nas rodadas.
    5. 
  

  
Critérios de correção

  

    
ItemValor

    
      
Primeira execução conferida no verificador, com o registro da rodada antes0,10

      
Alterações nas instruções e nos materiais atendem às regras do cenário, uma a uma0,15

      
Uma rodada após as alterações passa na checagem das regras do cenário, o gate0,10

      
Respostas 5, 6 e 7 do formulário explicam os resultados com base no registro0,15

    
  

  
Se o gate continuar reprovado após três rodadas, você pode receber 0,05 dos 0,10 desse item. Para isso, explique na resposta 7 qual regra falhou e o que tentou corrigir. Se tiver problema de crédito ou de modelo, registre no formulário e continue pela reserva com chat. Isso não reduz sua nota.






  
Alternativa em caso de falha

  
Reserva com chat

  
Use esta alternativa se tiver problema de conta, crédito ou modelo no Dify, mas ainda conseguir um chat gratuito. As instruções abaixo são as mesmas do fluxo.

  
    
    
  1. Comece pelo spec. Clique em Copiar prompt completo. Prompt é o texto que você envia à IA.
    2. 
    
  2. Abra uma conversa nova no Google AI Studio, envie o texto e cole a resposta de volta no campo do agente.
    3. 
    
  3. Repita com tester e coder, cada um em uma conversa nova. Eles precisam da resposta do spec.
    4. 
    
  4. Para fazer as alterações do seu cenário, edite a instrução e marque quais materiais cada agente deve receber.
    5. 
    
  5. Com as três respostas preenchidas, clique em Montar entrega e levar ao verificador.
    6. 
  

  
Use a mesma comparação entre antes e depois e entregue pelo formulário da sua turma.