Modelo reutilizável
Modelo de Especificação de Agente de IA do LAC
Padroniza a documentação de cada agente de IA do LAC, garantindo que identidade, objetivo, capacidades, limites, autorização, supervisão, execução, evidências e critérios de aceitação sejam descritos de forma consistente.
Orientação de uso
Como preencher este modelo
Este documento é um molde arquitetural. Cada nova página de agente
deve preservar a estrutura essencial e substituir os marcadores
[PREENCHER] por informações específicas.
Regra de qualidade:
um agente não deve ser considerado especificado apenas por possuir nome e objetivo.
A especificação precisa explicitar o que ele pode fazer, o que não pode fazer,
quais fontes consulta, quais ferramentas utiliza, quem o supervisiona e como sua
atuação será avaliada.
Proposto
Em especificação
Especificado
Em validação
Aprovado
Implantado
Suspenso
Descontinuado
Identificação do agente
| Identificador | [AG-XXX-000] |
| Nome | [NOME DO AGENTE] |
| Papel computacional | [FUNÇÃO PRINCIPAL] |
| Versão | [VERSÃO] |
| Estado | [PROPOSTO / ESPECIFICADO / IMPLANTADO] |
| Responsável arquitetural | [PAPEL OU PESSOA] |
| Supervisor humano | [PAPEL RESPONSÁVEL] |
| Subsistema de atuação | [SUBSISTEMA] |
Problema, objetivo e resultado esperado
Onde e quando o agente atua
Jornada
[JORNADA OU MOMENTO DA JORNADA]
Gatilho
[EVENTO QUE INICIA A ATUAÇÃO]
Estado inicial
[CONDIÇÕES NECESSÁRIAS PARA COMEÇAR]
Escopo
[DOMÍNIO, PÁGINAS, DADOS OU PROCESSOS]
Fora do escopo
[O QUE NÃO PERTENCE À ATUAÇÃO]
Dependências
[OUTROS AGENTES, FONTES OU SERVIÇOS]
Informações recebidas pelo agente
| Entrada | Origem | Formato | Obrigatória? | Validação |
|---|---|---|---|---|
| [ENTRADA 1] | [ORIGEM] | [TEXTO / JSON / EVENTO...] | [SIM / NÃO] | [REGRA DE VALIDAÇÃO] |
| [ENTRADA 2] | [ORIGEM] | [FORMATO] | [SIM / NÃO] | [REGRA] |
O que o agente sabe fazer
[CAPACIDADE 1]
[DESCRIÇÃO]
[CAPACIDADE 2]
[DESCRIÇÃO]
[CAPACIDADE 3]
[DESCRIÇÃO]
[CAPACIDADE 4]
[DESCRIÇÃO]
[CAPACIDADE 5]
[DESCRIÇÃO]
[CAPACIDADE 6]
[DESCRIÇÃO]
O que o agente pode consultar
| Fonte | Finalidade | Autoridade | Atualização | Restrições |
|---|---|---|---|---|
| [FONTE 1] | [USO] | [OFICIAL / AUXILIAR] | [FREQUÊNCIA] | [LIMITES] |
| [FONTE 2] | [USO] | [AUTORIDADE] | [ATUALIZAÇÃO] | [LIMITES] |
Recursos técnicos disponíveis
| Ferramenta | Função | Permissão necessária | Efeito |
|---|---|---|---|
| [FERRAMENTA 1] | [FUNÇÃO] | [CONSULTA / EXECUÇÃO] | [REVERSÍVEL / PERMANENTE] |
| [FERRAMENTA 2] | [FUNÇÃO] | [PERMISSÃO] | [EFEITO] |
Como o agente atua
1. Receber[ENTRADA]
2. Interpretar[ANÁLISE]
3. Consultar[FONTES]
4. Planejar[PLANO]
5. Autorizar[CONTROLE]
6. Executar[AÇÃO]
7. Verificar[RESULTADO]
Descrever também retornos, exceções, reformulação, interrupção e condições de parada.
Até onde o agente pode agir
Ações permitidas, condicionadas e proibidas
O que deve ser registrado
{
"id_execucao": "[ID]",
"agente": "[ID_DO_AGENTE]",
"versao": "[VERSAO]",
"objetivo": "[OBJETIVO]",
"entrada": "[ENTRADA]",
"contexto": "[CONTEXTO]",
"fontes_consultadas": [],
"plano": [],
"acoes_executadas": [],
"autorizacao": "[ID_AUTORIZACAO]",
"resultado": "[RESULTADO]",
"evidencias": [],
"intervencao_humana": false,
"incidente": null,
"status": "[STATUS]"
}
Entrada
Registrar o que iniciou a atuação.
Decisão
Registrar plano, regras e autorização usada.
Resultado
Registrar saída, evidência e eventual intervenção.
Critérios de aceitação do agente
Situação e próximos passos
| Estado atual | [ESTADO] |
| Ambiente | [CONCEITUAL / DESENVOLVIMENTO / PRODUÇÃO] |
| Última validação | [DATA E RESPONSÁVEL] |
| Próximo passo | [AÇÃO SEGUINTE] |
| Pendências | [PENDÊNCIAS] |