# 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.