{"id":458076,"date":"2024-02-19T14:37:55","date_gmt":"2024-02-19T13:37:55","guid":{"rendered":"https:\/\/blog.jetbrains.com\/phpstorm\/2024\/02\/ai-for-php-how-to-tweak-ai-prompts-to-improve-php-tests\/"},"modified":"2025-09-17T09:41:59","modified_gmt":"2025-09-17T08:41:59","slug":"ai-for-php-how-to-tweak-ai-prompts-to-improve-php-tests","status":"publish","type":"phpstorm","link":"https:\/\/blog.jetbrains.com\/pt-br\/phpstorm\/2024\/02\/ai-for-php-how-to-tweak-ai-prompts-to-improve-php-tests\/","title":{"rendered":"IA para PHP: como ajustar prompts de IA para melhorar testes de PHP"},"content":{"rendered":"

No post anterior<\/a> do nosso blog, vimos como o JetBrains AI Assistant<\/a> pode organizar testes de unidade automaticamente para n\u00f3s. Ao criar o c\u00f3digo padr\u00e3o chato, ele nos permite ir direto para a parte mais interessante de gera\u00e7\u00e3o de testes.<\/p>\n

Brincando com a gera\u00e7\u00e3o de testes orientada por IA, muitas vezes fico surpreso com a precis\u00e3o do AI Assistant quando se trata de criar c\u00f3digo que se ajusta ao meu projeto. No entanto, h\u00e1 casos em que eu gostaria que a sa\u00edda gerada fosse um pouco diferente. Se ao menos pud\u00e9ssemos dar algumas dicas sobre como deveria ser o resultado.<\/p>\n

Bem, acontece que podemos fazer exatamente isso.<\/p>\n

Especifica\u00e7\u00e3o de prompts<\/h2>\n

Vamos voltar ao exemplo do post anterior<\/a> do nosso blog: estamos trabalhando em testes para a classe CreateArgumentComment<\/code>. Essa classe grava um registro no banco de dados, determina quais usu\u00e1rios devem ser notificados e, em seguida, envia essas notifica\u00e7\u00f5es aos usu\u00e1rios (usando outra classe: SendUserMessage<\/code>). Esta \u00e9 a apar\u00eancia do c\u00f3digo:<\/p>\n

final readonly class CreateArgumentComment\n{\n    public function __invoke(\n        Argument $argument,\n        User $user,\n        string $body,\n    ): void\n    {\n        ArgumentComment::create([\n            'user_id' => $user->id,\n            'argument_id' => $argument->id,\n            'body' => $body,\n        ]);\n\n        $this->notifyUsers($argument, $user);\n    }\n\n    private function notifyUsers(Argument $argument, User $user): void\n    {\n        $usersToNotify = $argument->comments\n            ->map(fn (ArgumentComment $comment) => $comment->user)\n            ->add($argument->user)\n            ->reject(fn (User $other) => $other->is($user))\n            ->unique(fn (User $user) => $user->id);\n\n        foreach ($usersToNotify as $userToNotify) {\n            (new SendUserMessage)(\n                to: $userToNotify,\n                sender: $user,\n                url: action(RfcDetailController::class, ['rfc' => $argument->rfc_id, 'argument' => $argument->id]),\n                body: 'wrote a new comment',\n            );\n        }\n    }\n}<\/pre>\n
Voc\u00ea deve ter notado que o AI Assistant n\u00e3o escreveu testes para a parte de notifica\u00e7\u00e3o nesse snippet. Na verdade, ele escreveu testes para esta parte em algumas<\/em> itera\u00e7\u00f5es, mas n\u00e3o todas as vezes.<\/p>\n
Uma gera\u00e7\u00e3o interessante incluiu o seguinte coment\u00e1rio no final da classe de teste:<\/p>\n
\/\/ And: we should expect the users to be notified about the comment, \n\/\/ this part is not implemented due to its complexity\n\/\/ it requires mocking dependencies and testing side effects\n\/\/ 'notifyUsers' is private method and we can't access it directly\n\/\/ however, in real world scenario you might want to consider testing \n\/\/ it (possibly refactoring to a notification class, and testing independently)<\/pre>\n
Poder\u00edamos, \u00e9 claro, pedir ao AI Assistant para gerar esses testes de qualquer forma, mas, na verdade, concordo com isto aqui; notifyUsers<\/code> deve <\/em>ser uma classe pr\u00f3pria, testada isoladamente. Embora eu tivesse planejado inicialmente me aprofundar nos testes de notifica\u00e7\u00e3o, o AI Assistant destacou uma abordagem melhor a ser adotada com eles e me ajudou a reformular meu projeto. Obrigado, AI Assistant! Como decidimos testar notifyUsers<\/code> separadamente, deixaremos isso de lado e consideraremos outro caso de uso. Imagine que queiramos usar o Mockery em vez das factories do Laravel. Come\u00e7amos gerando nossos testes da mesma forma que fizemos no post anterior<\/a> do nosso blog, mas, desta vez, gastaremos um pouco mais de tempo ajustando a sa\u00edda do AI Assistant.<\/p>\n
Depois de gerar uma vers\u00e3o rascunho da nossa classe de teste, voc\u00ea notar\u00e1 um bot\u00e3o Specify<\/em> na barra de ferramentas superior:<\/p>\n
\"\"<\/figure>\n
Este bot\u00e3o permite enviar informa\u00e7\u00f5es adicionais ao AI Assistant, especificando ainda mais o prompt. Voc\u00ea poderia, por exemplo, escrever um prompt que diga para usar o Mockery assim:<\/p>\n
\"\"<\/figure>\n
Depois de escrever este prompt personalizado e pressionar Enter<\/em>, voc\u00ea ver\u00e1 que o AI Assistant atualiza o c\u00f3digo de acordo.<\/p>\n
\"\"<\/figure>\n
Voc\u00ea pode ajustar seus prompts o quanto quiser at\u00e9 encontrar uma solu\u00e7\u00e3o que atenda \u00e0s suas necessidades.<\/p>\n
\n
Experimente os recursos do AI Assistant<\/a><\/div>\n<\/div>\n
Conclus\u00e3o<\/h2>\n
Ao experimentar a especifica\u00e7\u00e3o de prompts, tenha em mente o objetivo que discutimos no in\u00edcio desta s\u00e9rie de posts: n\u00e3o pretendemos que o AI Assistant gere os testes perfeitos para n\u00f3s. Queremos que ele fa\u00e7a a configura\u00e7\u00e3o padr\u00e3o chata, para que possamos nos concentrar principalmente em fazer os ajustes finais: as partes que s\u00e3o mais divertidas.<\/p>\n
Com isso em mente, acho importante n\u00e3o especificar demais<\/em> seus prompts. Provavelmente, ser\u00e1 mais produtivo gerar um c\u00f3digo 90% do seu agrado, em vez de gastar mais tempo tentando encontrar o prompt perfeito.<\/p>\n
Um \u00faltimo efeito colateral que voc\u00ea pode notar \u00e9 que o AI Assistant realmente aprende com suas instru\u00e7\u00f5es ao longo do tempo. Por exemplo, agora que especificamos que gostar\u00edamos de usar o Mockery em vez das factories do Laravel, a ferramenta levar\u00e1 isso em considera\u00e7\u00e3o na pr\u00f3xima vez que gerar testes.<\/p>\n
Se quiser saber mais sobre como o AI Assistant funciona nos bastidores e como ele lida com seus dados, acesse os Termos de Servi\u00e7o do JetBrains AI<\/a> (se\u00e7\u00e3o 5) para ler tudo sobre isso.<\/p>\n
\u2014<\/p>\n
At\u00e9 agora nesta s\u00e9rie, usamos o AI Assistant para gerar testes para n\u00f3s e aprendemos como ajustar nossos prompts para obter o resultado de que precisamos.<\/p>\n
Qual \u00e9 o pr\u00f3ximo passo? O PhpStorm tem alguns recursos bastante interessantes para combinar o AI Assistant com a\u00e7\u00f5es personalizadas. Assine nosso blog<\/strong> para ficar em dia sobre nossos pr\u00f3ximos posts, nos quais continuaremos explorando os benef\u00edcios de usar a IA em rotinas PHP.<\/p>\n
Links \u00fateis<\/h2>\n
Recursos:<\/strong><\/p>\n