AzterDocs

Plataforma

Capabilities

Una capability es una operación canónica con contrato propio: schema de entrada y salida, scopes requeridos, semántica de idempotencia y trazas de auditoría. Una capability tiene una única implementación operacional; las distintas interfaces (runtime del agente, MCP, REST en desarrollo) la invocan, no la duplican.

Qué es una capability

  • Query — obtiene información sin efectos secundarios (p. ej. inventory.check).
  • Command — produce side effects y exige idempotencia por intento lógico (p. ej. contacts.update).
  • Cada ejecución registra auditoría (actor, capability, duración, resultado) y las queries devuelven provenance (origen, frescura, autoridad del dato).

Catálogo canónico

Hoy hay 6 capabilities canónicas disponibles en el runtime del agente, verificadas en producción. Esta referencia se genera desde el mismo catálogo machine-readable que consumen los servicios de Azter.

Disponibilidad por superficie

Que una capability exista no significa que esté expuesta en todas las interfaces. Esta es la disponibilidad real de cada superficie hoy:

Agent RuntimeDisponible6 capabilities canónicas activas y verificadas en producción.
MCPDisponibleServidor público mcp.azter.ai (10 tools). Unificación canónica en progreso.
Webhooks salientesDisponibleOutbox con firma HMAC, reintentos con backoff y entregas cada 30 s.
REST APIPlaneadaExpondrá el mismo Capability Core. Private preview antes del acceso general.
A2A / UCP / AP2PlaneadaConvergerán al mismo Capability Core cuando el estándar lo justifique.

Catálogo machine-readable

El mismo catálogo está disponible como JSON para tooling y agentes en /docs/capabilities.json.

Ejemplo

terminal
curl -s https://azter.ai/docs/capabilities.json | jq '.capabilities[] | {name, execution, requiredScopes}'

Honestidad sobre el estado

Este catálogo crece a medida que más operaciones migran al Capability Core. Lo que no aparece aquí todavía no es una capability canónica, aunque pueda existir como herramienta del servidor MCP.
AnteriorConceptosSiguiente Servidor MCP