Pular para o conteúdo principal

​
O que são playbooks?

​
Playbooks são prompts facilmente compartilháveis e reutilizáveis para tarefas recorrentes

Um Playbook é como um prompt de sistema personalizado para uma tarefa recorrente. Por exemplo, se você precisa ter muitas sessões diferentes do Devin que usem a mesma biblioteca de terceiros, mas em partes diferentes da sua aplicação, talvez você queira um Playbook. Playbooks também são facilmente compartilháveis e reutilizáveis, então, depois que alguém tiver sucesso com o Devin, outras pessoas podem replicar esse sucesso com mais facilidade!
A maioria das boas práticas, guias de estilo ou outras instruções específicas de projeto deve ser compartilhada com o Devin usando o Knowledge. Recomendamos ler a documentação sobre o Knowledge antes de criar Playbooks, para entender qual método atende melhor às suas necessidades.
Devin
Recomendamos usar Playbooks quando:
  • Você ou seus colegas de equipe vão reutilizar o prompt em várias sessões.
  • Você se pega repetindo os mesmos lembretes para o Devin.
  • O caso de uso pode ser relevante para outras pessoas — na sua organização ou na comunidade de usuários do Devin.

​
Introdução aos Playbooks

Os playbooks podem desbloquear imediatamente a capacidade do Devin de contribuir em uma ampla variedade de áreas, mas, hoje, exigem habilidade para serem escritos. De forma semelhante ao prompt engineering, escrever playbooks exige tentativa e erro. O fruto desse trabalho, porém, é um documento que libera a capacidade do Devin de realizar, de forma independente, trabalhos complexos — desde ingerir dados no Redshift e executar migrações de banco de dados até usar diferentes softwares e APIs, por exemplo: Together, Plaid, Stripe, Modal, Springboot, Odoo e Storybook.
Considere escrever seu primeiro playbook com uma tarefa simples, de múltiplas etapas, que você queira que o Devin execute.
  1. Crie um documento que descreva…
    1. O resultado que você quer que o Devin atinja
    2. As etapas necessárias para chegar lá
  2. Opcional: Adicione seções como Procedure, Specifications, Advice, Forbidden Actions ou Required from User
    1. Procedure: Descreva todo o escopo da tarefa. Inclua pelo menos uma etapa para configuração, a execução da tarefa em si e a entrega.
    2. Specifications: Descreva as pós-condições — o que deve ser verdadeiro depois que o Devin terminar?
    3. Advice: Inclua dicas para corrigir os pressupostos iniciais do Devin
    4. Forbidden Actions: Inclua qualquer ação que o Devin absolutamente não deve realizar
    5. Required from User: Descreva qualquer entrada ou informação necessária do usuário
  3. Crie o playbook diretamente no aplicativo web clicando em Criar um novo Playbook. Como alternativa, salve um arquivo com a extensão .devin.md e arraste e solte esse arquivo no aplicativo web ao iniciar uma sessão do Devin
Devin
Você terá anexado um playbook a uma sessão com sucesso se vir um botão azul em formato de pílula aparecer, junto com um componente inline para editar o playbook antes de iniciar sua sessão.
Devin

​
Como criar um excelente playbook

​
Procedure

A seção Procedure deve…
  • Ter um passo por linha, cada linha redigida no imperativo
  • Cobrir todo o escopo da tarefa
  • Incluir pelo menos um passo para preparação, a tarefa em si e entrega
  • Procurar tornar os passos mutuamente exclusivos e coletivamente exaustivos
  • Dicas adicionais
    • Os procedimentos devem ajudar você a definir a ordem das ações do Devin – como if/else/loops/goto em código
    • Não torne as tarefas específicas demais, a menos que seja realmente necessário; isso pode reduzir a capacidade do Devin de resolver problemas
    • Cada passo do procedimento deve conter um verbo de ação – por exemplo: escrever, navegar até, etc.

​
Dicas e Orientações

Compartilhe dicas e orientações com o Devin se…
  • Você tiver uma forma preferida de concluir as tarefas
  • A dica se aplicar à tarefa inteira ou a vários passos. Dicas específicas de um passo devem ser escritas ao lado desse passo (por exemplo, como um subitem)
  • Você estiver corrigindo os conhecimentos prévios do Devin. Dicas podem funcionar como comentários em pseudocódigo que influenciam sua execução.
Se a dica se aplicar somente a um passo do Procedimento, escreva a dica logo abaixo desse passo usando subitens em lista aninhada

​
Especificações

A seção de Especificações pode ser útil para descrever as pós-condições do playbook — quais condições devem ser atendidas quando Devin terminar?

​
O que é necessário do usuário

Considere tudo o que for necessário, mas que esteja fora do controle do Devin. Por exemplo, se o usuário precisar fornecer um token ou informações que não estejam publicamente disponíveis para o Devin.

​
Outras dicas + táticas

  • Execute 2 ou mais Devins em paralelo com o mesmo playbook para identificar rapidamente possíveis erros.
  • Se o Devin precisar de ajuda, converse com ele para ajudá-lo a avançar. Depois, adicione isso ao seu playbook para que o Devin tenha sucesso sem intervenção na próxima vez.
Seja explícito sobre qual é o entregável e como o Devin deve comunicar que ele está concluído (por exemplo, quais arquivos anexar ou quais links compartilhar, se houver).
Explore as diferentes decisões que o Devin pode tomar e oriente o Devin pelo caminho mais eficiente no playbook.
  • Eles podem ser o fator decisivo entre um playbook que funciona e um que falha.
  • Por exemplo, o seguinte pode ser um ótimo detalhe para incluir, pois “alloy” e “tts-1” provavelmente não seriam escolhas que o Devin faria por conta própria, e isso orienta o Devin em uma direção com maior chance de sucesso!
3. Create request dict with model: "tts-1", voice: "alloy"

​
Playbook de exemplo

Visualize sessões de exemplo usando o playbook abaixo aqui e aqui.

​
Macros

Você pode atribuir uma macro a qualquer playbook — um identificador curto que começa com ! (por exemplo, !data-tutorial). As macros permitem vincular rapidamente um playbook a uma sessão digitando o nome da macro no campo de prompt. As macros podem conter apenas letras, números e hífens, e devem ser exclusivas dentro da sua organização.

​
Histórico de versões

Os playbooks mantêm um histórico de versões para que você possa acompanhar as alterações ao longo do tempo. Cada vez que você edita e salva um playbook, uma nova versão é criada. Você pode visualizar versões anteriores e reverter para uma versão anterior se uma alteração recente não sair como esperado.

​
Playbooks do Enterprise

Para clientes Enterprise, os playbooks podem ser gerenciados no nível Enterprise, além do nível da organização. Os playbooks Enterprise são compartilhados entre todas as organizações do seu Enterprise, facilitando a padronização de fluxos de trabalho entre equipes. Os administradores do Enterprise podem criar e gerenciar playbooks no nível Enterprise nas configurações do Enterprise.