Gestão de Prompts dos Agentes¶

O AMia usa o princípio Prompt As Code: os prompts dos agentes são versionados como código no repositório amIA-PromptAsCode e publicados automaticamente via pipeline CI/CD.

Como os prompts funcionam¶

amIA-PromptAsCode (repo Git)
        ↓ merge na branch principal
   Pipeline CI/CD Azure DevOps
        ↓ POST /api/v1/prompts/{key}/versions
   AMia Core (banco de dados)
        ↓ GET /api/v1/prompts/{key}
   AMia Agents (runtime)

Os agentes nunca usam prompts hardcoded — em produção, sempre consomem do Core via HTTP.

Visualizar versões de prompt no Portal¶

Acesse Administração → Prompts no Portal
Selecione o agente desejado
Visualize as versões disponíveis com histórico de publicações

Somente leitura no Portal

O Portal exibe o histórico de versões, mas não permite edição direta. Toda alteração de prompt deve ser feita via Pull Request no repositório amIA-PromptAsCode.

Publicar nova versão de prompt¶

Abra o repositório amIA-PromptAsCode
Edite o arquivo de prompt correspondente em prompts/
Atualize o frontmatter com a nova versão
Crie um Pull Request e aguarde revisão
Após merge na branch principal, o pipeline publica automaticamente no Core

O prompt entra em vigor imediatamente nos próximos requests dos agentes — sem redeploy de containers.

Reverter para versão anterior¶

O rollback é feito via revert de commit no repositório amIA-PromptAsCode:

git revert <commit-hash>
git push origin main

O pipeline detecta o merge e publica a versão anterior como nova versão ativa.