Aprenda a usar saída estruturada com eficiência e interagir com sessões do Devin via API
Saída estruturada é como o bloco de notas do Devin — ele atualiza suas anotações enquanto trabalha, e você pode consultá-las a qualquer momento. No momento, você não pode forçar o Devin a atualizar essas anotações, mas pode solicitar para ver o que ele escreveu até agora.
Atualizações de Progresso
Receba atualizações sobre o progresso do Devin durante tarefas de longa duração
Integração com Aplicações
Encaminhe a análise e as saídas do Devin para suas aplicações usando JSON consistente.
Para usar saída estruturada, inclua o schema JSON desejado no prompt ao criar uma sessão.
Certifique-se de instruir o Devin a atualizar a saída estruturada sempre que algo relevante acontecer.
Revisão de PR
Atualizações de progresso
Resultados de testes
Implementação de funcionalidade
Copiar
Perguntar à IA
{ "prompt": "Review this PR and provide updates in this format. Please update the structured output immediately whenever you find new issues, have suggestions, or change your approval status:\n{ "issues": [ { "file": "src/App.tsx", "line": 42, "type": "bug", "description": "Memory leak in useEffect cleanup" } ], "suggestions": [ "Add error handling for API calls", "Split component into smaller parts" ], "approved": false }"}
Formato simples para revisões de PR e análise de código.
Copiar
Perguntar à IA
{ "prompt": "As you work, provide updates in this format. Please update the structured output immediately whenever you start a new task, complete a task, or plan your next task:\n{ "status": "in_progress", "current_task": "Adding authentication to login page", "completed_tasks": [ "Set up project structure", "Added routing" ], "next_task": "Implement form validation" }"}
Acompanhe no que o Devin está trabalhando no momento e o que vem em seguida.
Copiar
Perguntar à IA
{ "prompt": "When running tests, report results in this format. Please update the structured output immediately after each test run and whenever coverage changes:\n{ "tests_passed": 25, "tests_failed": 2, "failing_tests": [ { "name": "login_validation", "error": "Expected error message to be shown" } ], "coverage": 85 }"}
Visão geral simples dos resultados da execução de testes.
Copiar
Perguntar à IA
{ "prompt": "Build a user settings page and track progress in this format. Please update the structured output immediately whenever you complete a requirement, create new files, identify review items, or change testing status:\n{ "requirements_met": { "can_change_password": true, "can_update_email": false, "dark_mode_toggle": true }, "files_created": [ "UserSettings.tsx", "useUpdateProfile.ts" ], "needs_review": [ "Email update flow needs security review" ], "ready_for_testing": false }"}
Acompanhe a implementação da funcionalidade em relação a requisitos específicos.
Defina a frequência de atualização esperada (por exemplo: “Atualize a saída estruturada sempre que adicionar um novo componente ao site”)
Documente claramente os tipos e formatos de valores
Use nomes de campos claros e descritivos para que Devin saiba o que escrever
Inclua valores de exemplo no seu schema
Use intervalos de polling de 10 a 30 segundos para evitar sobrecarregar a Devin API
Pare o polling quando a sessão for concluída ou apresentar erro
Lembre-se de que Devin atualiza a saída estruturada no seu próprio ritmo — você não pode forçar uma atualização, mas pode pedir para ver as notas mais recentes a qualquer momento.
Em caso de dúvidas sobre o uso de saída estruturada ou para relatar problemas, envie um email para [email protected].
