Escrever as instruções de um assistente
Estruturar instruções verificáveis, escritas com os futuros utilizadores.
ObjetivoNo final desta lição, saberá redigir com os futuros utilizadores instruções de assistente verificáveis, estruturadas em função e público, resultado, fontes, limites e conduta em caso de dúvida.
As instruções são o texto permanente que enquadra um assistente. Dizem a quem se dirige, o que deve produzir, como, e o que não deve fazer. É a etapa de co-conceção participativa do ciclo WorkStreams: as instruções escrevem-se com as pessoas que vão utilizar o assistente, e não apenas para elas.
A estrutura que funciona
- Função e público: «Ajudas a equipa de contabilidade a responder às perguntas dos colaboradores sobre as notas de despesas.»
- Resultado esperado: formato, extensão, língua e tom.
- Fontes de referência: os documentos que fazem fé em caso de dúvida.
- Limites: o que não faz, e para quem encaminha a pessoa.
- Conduta em caso de incerteza: fazer uma pergunta ou dizer que não sabe, nunca inventar.
Escreva instruções verificáveis. «Sê claro» não se testa. «Responde em cinco linhas no máximo e cita o artigo da diretiva em causa» testa-se. Cada frase das instruções deve poder ser controlada numa resposta real.
Um workshop de co-conceção
- Reúna três ou quatro futuros utilizadores durante uma hora.
- Peça a cada um que traga duas perguntas reais recebidas recentemente.
- Peça ao Learnya que redija uma primeira versão das instruções a partir das notas do workshop.
- Testem juntos as perguntas trazidas numa conversa do projeto.
- Corrija as instruções em direto e depois volte a lançar as mesmas perguntas para comparar.
O workshop tem um segundo efeito, tão importante como o primeiro. As pessoas que escreveram as instruções compreendem porque é que o assistente responde assim, e defendem-no junto dos colegas. Um assistente concebido sem elas continua a ser a ferramenta de outra pessoa.