169 lines
3.2 KiB
Markdown
169 lines
3.2 KiB
Markdown
# SPEC-015 — Adoption and Eligibility Criteria
|
|
|
|
## Agent Platform OCI
|
|
|
|
Version: 1.0.0
|
|
|
|
|
|
---
|
|
|
|
## Reading guide
|
|
|
|
each SPEC is organizada for servir tanto como Contract arquitetural quanto como guia practical of adoção.
|
|
|
|
The document structure is:
|
|
|
|
1. Concept.
|
|
2. Problem addressed.
|
|
3. When to use.
|
|
4. When not to use.
|
|
5. Architecture.
|
|
6. Implementation.
|
|
7. Examples.
|
|
8. Common errors.
|
|
9. Acceptance criteria.
|
|
|
|
---
|
|
|
|
|
|
# 1. Concept
|
|
|
|
criteria of adoção definem when a projeto must use a Agent Platform OCI and quais Requirements minimum precisa atender for entrar em Development, homologação and Production.
|
|
|
|
# 2. Problem addressed
|
|
|
|
without criteria claros:
|
|
|
|
- qualquer caso simples vira Agent;
|
|
- projetos without owner entram on the platform;
|
|
- canais entram without Contract;
|
|
- Agents entram without dataset;
|
|
- Production ocorre without evaluator;
|
|
- Operations fica without dashboard/Alert.
|
|
|
|
# 3. Casos indicados
|
|
|
|
| Caso | Example |
|
|
| --- | --- |
|
|
| Agents conversational | Atendimento, suporte, backoffice. |
|
|
| Multiagentes | Handoff between domínios. |
|
|
| Agents with tools | Consulta/ação em sistemas. |
|
|
| Agents with RAG | Uso of documentos and Policies. |
|
|
| Ambientes regulados | Necessidade of Governance and auditoria. |
|
|
| Canais corporativos | Web, WhatsApp, Voice, URA, CRM. |
|
|
|
|
|
|
# 4. Casos No indicados
|
|
|
|
| Caso | Motivo |
|
|
| --- | --- |
|
|
| CRUD simples | API REST without IA. |
|
|
| ETL batch | Pipeline of Data. |
|
|
| Job agendado simples | without interação. |
|
|
| service utilitário | Validation/formatação simples. |
|
|
| integration without Decision | Proxy API without raciocínio. |
|
|
|
|
|
|
# 5. criteria of Input of negócio
|
|
|
|
before iniciar:
|
|
|
|
- business owner;
|
|
- technical owner;
|
|
- objective;
|
|
- Scope;
|
|
- outside of Scope;
|
|
- canais;
|
|
- sistemas;
|
|
- documentos;
|
|
- criteria of success;
|
|
- Risks.
|
|
|
|
# 6. criteria of Architecture
|
|
|
|
required:
|
|
|
|
- GatewayRequest;
|
|
- ChannelResponse;
|
|
- BusinessContext;
|
|
- health/readiness;
|
|
- logs;
|
|
- traces;
|
|
- dataset;
|
|
- evaluator;
|
|
- certification.
|
|
|
|
# 7. criteria of Security
|
|
|
|
required:
|
|
|
|
- Authentication;
|
|
- Authorization;
|
|
- secrets external;
|
|
- máscara of PII;
|
|
- auditoria;
|
|
- Review of Risk.
|
|
|
|
# 8. criteria of quality
|
|
|
|
required:
|
|
|
|
- Tests unitários;
|
|
- Tests of integration;
|
|
- dataset;
|
|
- evaluator;
|
|
- thresholds;
|
|
- certification.
|
|
|
|
# 9. criteria of Operations
|
|
|
|
required:
|
|
|
|
- Metrics;
|
|
- dashboards;
|
|
- Alerts;
|
|
- runbook;
|
|
- rollback;
|
|
- SLO.
|
|
|
|
# 10. Process of exceção
|
|
|
|
Exceptions permitidas:
|
|
|
|
- without RAG;
|
|
- without MCP;
|
|
- without Memory;
|
|
- without handoff;
|
|
- without canal External.
|
|
|
|
Toda exceção Must record:
|
|
|
|
```yaml
|
|
exception:
|
|
reason: "Agente não usa documentos"
|
|
approved_by: architecture
|
|
expires_at: 2026-12-31
|
|
```
|
|
|
|
# 11. Checklist of adoção
|
|
|
|
- [ ] Business owner definido.
|
|
- [ ] Technical owner definido.
|
|
- [ ] Scope definido.
|
|
- [ ] Casos outside of Scope definidos.
|
|
- [ ] GatewayRequest definido.
|
|
- [ ] BusinessContext definido.
|
|
- [ ] Security definida.
|
|
- [ ] Dataset criado.
|
|
- [ ] Evaluator configured.
|
|
- [ ] Certification planejada.
|
|
- [ ] Observability planejada.
|
|
|
|
# 12. Acceptance criteria
|
|
|
|
- [ ] Projeto elegível for plataforma.
|
|
- [ ] Requirements minimum atendidos.
|
|
- [ ] Exceptions documentadas.
|
|
- [ ] Plano of homologação definido.
|
|
- [ ] criteria of Production definidos.
|