Marco bien estructurado

Salesforce Well-Architected Framework proporciona a los arquitectos una base de principios compartida para tomar las decisiones que ayudan a que una solución tenga éxito con el tiempo. Está organizado en torno a cinco pilares: Trust, Reliability, Operational Excellence, Optimización de recursos y costes y Fairness, cada uno de los cuales captura una dimensión de calidad que importa en cada etapa de la vida de una solución, desde el diseño inicial hasta la operación y el crecimiento a largo plazo.

El marco aborda las realidades que enfrentan los arquitectos hoy: humanos, agentes y plataformas que trabajan juntos dentro de sistemas comerciales gobernados. Una solución segura pero frágil bajo carga, o eficiente pero opaca en sus decisiones, no está bien diseñada. Estos cinco pilares trabajan conjuntamente para garantizar que la calidad se trate en su conjunto y no como una lista de comprobación de preocupaciones independientes.

Los arquitectos utilizan el marco de trabajo como una lente coherente durante revisiones de diseño, conversaciones de compensación y gobernanza continua. No prescribe una única respuesta correcta. Le proporciona las preguntas correctas para formular, los patrones correctos a tener en cuenta y un vocabulario común para utilizar entre equipos.

Salesforce Well-Architected Framework es una guía con opiniones sobre la calidad arquitectónica para soluciones creadas sobre Salesforce Platform. Codifica los principios, patrones y compensaciones que distinguen las soluciones que se amplían y se adaptan de aquellas que acumulan deuda técnica o fallan bajo presión.

El marco se organiza en torno a cinco pilares. Cada pilar define una dimensión de calidad, articula principios de diseño principales, identifica patrones comunes y proporciona directrices explícitas tanto para funciones de plataforma tradicionales como cargas de trabajo de IA de agentes. Juntos, los pilares cubren de forma integral lo que significa crear algo bien en Salesforce.

Este marco no es un manual de producto o una guía de implementación. Es un marco de decisiones de arquitectura, una forma de pensar en la calidad que se aplica independientemente de qué nubes, funciones o herramientas utiliza una solución.

Los marcos de trabajo del sector de proveedores de nube de hiperescala proporcionan directrices generales valiosas, pero se crean principalmente para problemas operativos y de infraestructura de nube, como máquinas virtuales, redes, almacenamiento e informática. Los arquitectos de Salesforce se enfrentan a diferentes restricciones y funciones: plataforma multiusuario con límites reguladores, décadas de lógica comercial en Customer 360, soluciones de integración sofisticadas, automatización declarativa, configuración dirigida por metadatos y modelos de colaboración gestionados. Estas dan forma a cada decisión arquitectónica de formas que las directrices genéricas en la nube no pueden abordar.

El cambio a agentes autónomos introduce consideraciones adicionales. Los agentes que razonan y actúan introducen patrones de supervisión no determinista, probabilista y humana en bucle que los marcos de trabajo anteriores no abordaban originalmente, aunque los marcos de trabajo de propósito general han comenzado a extenderse a este espacio a través de lentes de IA dedicadas. Salesforce Well-Architected Framework se dirige tanto a la arquitectura de plataforma tradicional como a los sistemas agentes a través de una lente unificada.

Este marco de trabajo sirve a cualquier responsable de la calidad arquitectónica en la plataforma Salesforce:

• Salesforce Architects diseñando nuevas soluciones o ampliando las existentes
• Administradores de Salesforce configurando y protegiendo las organizaciones donde se ejecutan estas soluciones
• Candidatos de desarrollo que establecen estándares y patrones para sus equipos
• Consultores y socios asesorando a clientes sobre prácticas recomendadas de plataforma
• IA y especialistas en agentes que crean y rigen sistemas de agentes autónomos

No se requiere experiencia previa en IA de agentes. El marco es accesible para todos los arquitectos, proporcionando profundidad para aquellos que trabajan en la frontera de sistemas autónomos.

No existe un único orden de lectura correcto. Seleccione en base a su función y necesidad inmediata:

• Si es nuevo en el marco de trabajo: Lea este documento de descripción general de extremo a extremo y luego explore el pilar más relevante para su proyecto actual.
• Si está diseñando una nueva solución: Comience con Trust and Reliability (fundamentos no negociables) y luego aborde la Excelencia operativa (cómo la operará), la Optimización de recursos y costes (cómo la mantendrá) y la Justicia (cómo se asegurará de que sirve a todos los usuarios de forma equitativa).
• Si está creando soluciones de agentes: Lea primero la Descripción general de la empresa para obtener directrices integrales sobre la arquitectura de agentes. A continuación lea los documentos de pilares principales (vinculados anteriormente) para patrones fundamentales: Modelo de responsabilidad compartida, límites reguladores, herramientas de supervisión, modelado de TCO, estándares de accesibilidad, sobre los que se basan las soluciones de agentes. Finalmente, haga referencia a las variantes de pilares de Agentic Enterprise (vinculadas desde cada pilar) para superposiciones específicas de agentes en cada dimensión de calidad.
• Si está realizando una revisión de diseño: Utilice los documentos de pilar como una lista de comprobación de revisión estructurada. Una solución bien estructurada tiene respuestas claras a las preguntas clave en cada pilar relevante.

Las decisiones arquitectónicas más importantes implican compensaciones entre pilares. El marco de trabajo le ayuda a explicitar lo siguiente:

• Confianza frente a optimización de recursos y costes: El cifrado y el registro de auditoría consumen recursos. El marco de trabajo le ayuda a identificar dónde el requisito Trust no es negociable frente a dónde tiene flexibilidad.
• Fiabilidad frente a Optimización de recursos y costes: Mayor disponibilidad cuesta más. Las definiciones de SLO le ayudan a hacer coincidir la inversión con los requisitos comerciales reales en vez de utilizar como valor predeterminado la redundancia máxima.
• Excelencia operativa frente a velocidad: La observabilidad integral y las pruebas tardan tiempo en implementarse. El marco de trabajo le ayuda a identificar la observabilidad mínima viable para su perfil de riesgo.
• Equidad frente a autonomía: Una mayor autonomía de los agentes permite la eficiencia pero crea riesgo de equidad. Los patrones humanos en bucle le ayudan a encontrar el equilibrio correcto para cada tipo de decisión.

No existe una respuesta universal a estas compensaciones. El marco de trabajo le ayuda a formular las preguntas correctas y hacer las compensaciones de forma consciente en vez de descubrirlas en producción.

El marco de trabajo bien diseñado en sí está diseñado teniendo en cuenta estos principios:

• Específico de la plataforma, pero que distingue entre tecnologías: Directrices soluciona restricciones específicas de Salesforce (límites reguladores, arquitectura de múltiples arrendatarios, configuración dirigida por metadatos) sin prescribir productos o funciones específicos. Los arquitectos eligen las funciones correctas para su contexto.
• Opinó sin ser prescriptivo: El marco adopta posiciones claras sobre lo que constituye calidad, pero no dicta una única vía de aplicación. Proporciona principios, patrones y preguntas, no requisitos.
• Vista hacia el futuro respetando el presente: El marco aborda patrones emergentes (IA genética, sistemas autónomos) mientras sigue siendo relevante para soluciones de plataforma tradicionales. Ambos casos de uso se benefician de los mismos principios fundamentales.
• Vivo, no estático: El marco de trabajo evoluciona a medida que cambian la plataforma, las prácticas del sector y las necesidades de los clientes. El Registro de cambios realiza un seguimiento de las actualizaciones de modo que los arquitectos puedan mantenerse al día con nuevas directrices.
• Recurrible en cada etapa: Si está diseñando una nueva solución, realizando una revisión o mejorando una implementación existente, el marco proporciona directrices relevantes. No es solo una lista de comprobación de certificación, es una herramienta de trabajo.

Estos principios garantizan que el marco de trabajo siga siendo útil en diversos contextos arquitectónicos mientras mantiene directrices claras y coherentes sobre lo que significa la calidad arquitectónica para las soluciones de Salesforce.

Cada pilar aborda una dimensión fundamental de la calidad arquitectónica. Juntos, los pilares proporcionan una cobertura integral: ningún pilar es suficiente por sí solo, y las compensaciones entre pilares son donde viven las decisiones arquitectónicas más importantes.

Los cinco pilares siguientes proporcionan directrices arquitectónicas fundamentales para todas las soluciones de Salesforce: aplicaciones de plataforma tradicionales, integraciones y sistemas agentes por igual. La Descripción general de la empresa y sus variantes de pilares complementarios proporcionan la superposición específica de agentes: cómo se basan los agentes en estas funciones, qué cambia cuando los sistemas actúan de forma autónoma y los patrones arquitectónicos requeridos para la IA gobernada.

Utilice ambos juntos:

• Comience con las directrices de pilares para patrones arquitectónicos principales (por ejemplo, el Modelo de responsabilidad compartida, límites reguladores, herramientas de supervisión, modelado de TCO, estándares de accesibilidad).
• A continuación, haga referencia al pilar Empresa de agentes correspondiente para consideraciones específicas de los agentes (por ejemplo, permisos de agentes y cadenas de auditoría, gestión de fallos de orquestación, Ciclo de vida de desarrollo de agentes, optimización de tokens, Unidades de trabajo de agentes, explicabilidad y capacidad de impugnación).

Los pilares no son “tradicionales” frente a “agénticos”, son arquitectura fundamental sobre la que se basan las soluciones de agentes. Los sistemas agentes deben satisfacer los mismos requisitos Trust, fiabilidad, excelencia operativa, optimización de recursos y costes y equidad que cualquier otra solución empresarial, con consideraciones adicionales para la operación autónoma.

Esta tabla proporciona una referencia rápida. Siguen directrices detalladas para cada pilar.

Proteja su solución, sus datos y sus usuarios a través de seguridad moderna, acceso con menos privilegios, controles de privacidad y una gobernanza clara. Trust on Salesforce funciona a través del modelo de responsabilidad compartida: Salesforce protege la infraestructura y la plataforma, luego diseña soluciones seguras sobre esa base. Su responsabilidad abarca:

• Gestión de identidad y acceso (funciones, perfiles, conjuntos de permisos, MFA, SSO, OAuth)
• Gobernanza de datos (Shield Platform Encryption, seguridad a nivel de objeto/campo/registro)
• Seguridad de integración (autenticación de API, credenciales nombradas)
• Prácticas de desarrollo seguras (OWASP Top 10 adaptadas para Salesforce, análisis estático, puertas de seguridad de CI/CD)

Para soluciones agentes: Cuando los agentes actúan de forma autónoma, los requisitos Trust se extienden a la regulación de lo que se permite a los agentes hacer, la auditoría de lo que han hecho y la protección de los límites de agente a plataforma (Agent Fabric, Einstein Trust Layer). Consulte Agentic Enterprise Trust.

Para obtener más información, consulte Pilar Confianza y Agentic Enterprise Trust.

Diseño para disponibilidad continua, recuperación rápida de interrupciones y la capacidad de escalar bajo demanda inesperada. La fiabilidad requiere comprender las garantías de la plataforma (infraestructura de múltiples regiones, SLA de plataforma) mientras diseña soluciones que permanecen fiables dentro de esas restricciones. El pilar cubre:

• Límites reguladores con directrices de techo operativo del 70%
• Patrones de procesamiento asíncrono (Apex por lotes, Apex en cola, Eventos de plataforma)
• Disyuntores para integraciones externas
• Planificación de capacidad
• Pruebas de carga
• Patrones de múltiples organizaciones
• Recuperación de desastres
• Modelado de salud

Para soluciones agentes: Los sistemas dirigidos por agentes introducen un comportamiento probabilista que requiere nuevos patrones para fallos de orquestación, disyuntores para errores de agentes en cascada y gráficos de agentes deterministas donde los resultados comerciales requieren previsibilidad. Consulte Fiabilidad de empresa.

Para obtener más información, consulte Pilar de fiabilidad y Fiabilidad de agencia Enterprise.

Cree observabilidad integral en su solución y gestione la misma a través de procedimientos y automatización bien definidos. Excelencia operativa abarca:

• Observabilidad (Supervisión de eventos, Proactive Monitoring, Centro de escala)
• Prácticas de DevOps (desarrollo dirigido por origen, oportunidades en curso de CI/CD, estrategia de prueba)
• Automatización (declarativa-primera con Flow Builder, patrones programáticos con Apex)
• Gestión de incidentes (niveles de gravedad, rotación a petición, autopsias sin culpa)
• Mejora continua (mediciones DORA, revisiones operativas)

Para soluciones agentes: La observabilidad se vuelve más difícil cuando el comportamiento del sistema es probabilista. El ciclo de vida de desarrollo de agentes (ADLC) proporciona estructura a través de cinco fases: ideación y diseño, desarrollo, pruebas y validación (incluyendo evaluaciones del Centro de pruebas de agentes para precisión, coherencia y adhesión a instrucciones), implementación y versión, y supervisión y ajuste (incluyendo Rastreo de sesiones Agentforce para visibilidad de interacción de extremo a extremo). Consulte Agentic Enterprise Operational Excellence.

Para obtener más información, consulte Pilar de excelencia operativa y Excelencia operativa empresarial.

Devuelva el valor comercial máximo por cada dólar y cada unidad de recurso de plataforma, a través del uso eficiente de lo que tiene e inversión deliberada en lo que compra. En el lado del recurso, esto significa comprender los límites reguladores (consultas SOQL, declaraciones DML, tamaño de pila, tiempo de CPU) y diseñar dentro de ellos a través de la optimización SOQL, el procesamiento asíncrono y la prevención de sesgos de datos. Por el lado del coste, significa modelado de TCO integral tanto en costes directos (implementación, operación, mantenimiento) como indirectos (deuda técnica, gastos generales de gobernanza) que a menudo superan los costes de licencia directos. El pilar cubre:

• Patrones de organización de código (controladores de desencadenadores, capas de servicio, selectores)
• Empaquetado y modularidad (paquetes gestionados 2GP frente a desbloqueados, que son ambos tipos de empaquetado de segunda generación, composición LWC)
• Gestión del ciclo de vida de datos (estrategias de archivado, optimización de flujos)
• Herramientas de supervisión de rendimiento (Centro de escala, Herramienta de plan de consulta, ApexGuru, Salesforce Code Analyzer)
• Análisis de compilación frente a compra (evaluación de AgentExchange)
• Optimización de licencias y entornos sandbox
• Supervisión y gobernanza de costes (paneles, controles de presupuesto, modelos de devolución frente a devolución de cargos)

Para soluciones agentes: Los flujos de trabajo de agentes componen el consumo de recursos entre pasos de razonamiento, llamadas de herramientas y recuperaciones de datos, de modo que el uso de tokens, la latencia de inferencia y los patrones de memoria requieren optimización. Los sistemas agentes también introducen costes basados en consumo (Flex Credits, tokens de inferencia) que son más difíciles de predecir que las licencias por usuario. Las unidades de trabajo agente (AWU) miden el trabajo que los agentes completan actualmente (tareas discretas realizadas) en vez del consumo de tokens sin procesar. Consulte Optimización de costes y recursos empresariales de agencia.

Para obtener más información, consulte Pilar de optimización de recursos y costes y Optimización de recursos y costes empresariales.

Asegúrese de que su solución es accesible, no discriminatoria, inclusiva y transparente, con la supervisión humana apropiada de decisiones automatizadas. La equidad se basa en cimientos de plataforma. Salesforce Lightning Design System (SLDS) proporciona accesibilidad integrada para componentes estándar, mientras que los componentes personalizados requieren la implementación explícita de WCAG 2.1 AA (con WCAG 2.2 AA, la Recomendación actual del W3C a diciembre de 2024, recomendada para nuevos trabajos). El pilar cubre:

• Pruebas de accesibilidad (eje-core, escáner sfdx)
• Patrones de no discriminación (OWD, reglas de colaboración, FLS con Supervisión de eventos Shield)
• Arquitectura de privacidad (gestión de consentimiento de Data 360, Seguimiento de auditoría de campo)
• Gobernanza de la ética de IA (comités de revisión, puertas de equidad, cumplimiento normativo).

Para soluciones agentes: Cuando los agentes toman decisiones autónomas que afectan a las personas, aumenta la equidad. La explicabilidad (comprensión de por qué actuó un agente), la impugnabilidad (impugnación de decisiones) y Human-in-the-Loop (supervisión proporcional) se vuelven críticas. Consulte Agentic Enterprise Fairness.

Para obtener más información, consulte Pilar de equidad y Equidad de empresa.

No existe ningún pilar aislado. Las decisiones arquitectónicas en un pilar afectan inevitablemente a otros:

• Los controles Trust más sólidos (cifrado, registro de auditoría) consumen más recursos y agregan costes (Optimización de recursos y costes) y agregan latencia que afecta a la fiabilidad
• Mayor fiabilidad (redundancia, multirregión) aumenta el coste (Optimización de recursos y costes) y la complejidad operativa (Excelencia operativa)
• La aplicación más completa de la equidad (supervisión humana, supervisión de sesgos) ralentiza el rendimiento de los agentes (Optimización de recursos y costes)
• Mayor madurez de Excelencia Operativa (instrumentación integral) permite una mejor aplicación Trust y una detección de problemas de equidad más temprana

Estas interacciones significan que la calidad arquitectónica es siempre un equilibrio. El marco de trabajo ayuda a los arquitectos a comprender lo que están negociando y realizar esas negociaciones de forma intencionada. El objetivo no es maximizar cada pilar de forma simultánea, sino alcanzar el perfil de calidad correcto para los requisitos, la tolerancia al riesgo y el contexto comercial de una solución concreta.

Comparta sus comentarios sobre el Marco bien diseñado.