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¶

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

Publicar nova versão de prompt¶

1. Abra o repositório amIA-PromptAsCode
2. Edite o arquivo de prompt correspondente em prompts/
3. Atualize o frontmatter com a nova versão
4. Crie um Pull Request e aguarde revisão
5. 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.

Agentes e seus prompts¶