agent_framework_oci/specs/en/SPEC-015-Adoption-and-Eligibility-Criteria.md

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:

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.