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 costos y Justicia, 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 en sistemas de negocio 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 en una lista de comprobación de preocupaciones independientes.

Los arquitectos utilizan el marco de trabajo como una lente coherente durante revisiones de diseño, pláticas 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.

El Marco de trabajo bien arquitectado de Salesforce es una guía con opiniones sobre la calidad arquitectónica para soluciones creadas sobre Salesforce Platform. Codifica los principios, los patrones y las 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 para funciones de plataforma tradicionales y cargas de trabajo de IA de agentes. Juntos, los pilares cubren de forma integral lo que significa crear algo bien en Salesforce.

Este marco de trabajo 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 de la industria de proveedores de nube de hiperescala proporcionan valiosas directrices generales, 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 de negocio 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 presenta consideraciones adicionales. Los agentes que razonan y actúan introducen patrones de supervisión no determinista, probabilista y humana en bucle que los marcos 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 exclusivas. El Marco de trabajo bien arquitectado de Salesforce aborda la arquitectura de plataforma tradicional y los sistemas de 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
• Prospectos de desarrollo que establecen estándares y patrones para sus equipos
• Consultores y socios asesorando a clientes sobre mejores prácticas 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á), Optimización de recursos y costos (cómo la mantendrá) y Justicia (cómo se asegurará de que sirve a todos los usuarios de forma equitativa).
• Si está creando soluciones de agentes: Lea la Descripción general de la compañía de agencia primero para obtener directrices integrales sobre la arquitectura de agentes. Luego lea los documentos de pilares principales (vinculados anteriormente) para patrones fundamentales (Modelo de responsabilidad compartida, límites reguladores, herramientas de monitoreo, 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 diseñada 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 hacer explícitos estos aspectos:

• Confianza frente a Optimización de recursos y costos: El cifrado y el registro de auditoría consumen recursos. El marco 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 costos: Mayor disponibilidad cuesta más. Las definiciones de SLO le ayudan a hacer coincidir la inversión con los requisitos de negocio reales en vez de tomar 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 viable mínima 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 realizar 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 con tecnología específica: Las directrices solucionan restricciones específicas de Salesforce (límites reguladores, arquitectura de múltiples arrendatarios, configuración dirigida por metadatos) sin prescribir funciones o productos 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 ruta de aplicación única. Proporciona principios, patrones y preguntas, no requisitos.
• Vista hacia el futuro respetando el presente: El marco de trabajo 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 de la industria y las necesidades de los clientes. El Registro de cambios realiza un seguimiento de las actualizaciones de modo que los arquitectos puedan permanecer al día con nuevas directrices.
• Aplicable en cada etapa: Si está diseñando una nueva solución, realizando una revisión o mejorando una implementación existente, el marco de trabajo 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 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 que siguen proporcionan directrices arquitectónicas fundamentales para todas las soluciones de Salesforce: aplicaciones de plataforma tradicionales, integraciones y sistemas de agentes por igual. La Descripción general de la compañía de agentes 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 monitoreo, modelado de TCO, estándares de accesibilidad).
• A continuación, haga referencia al pilar Compañía de agente correspondiente para consideraciones específicas de 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, capacidad de explicación y concursabilidad).

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

Esta tabla proporciona una referencia rápida. A continuación encontrará 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 usted diseña soluciones seguras sobre esa base. Su responsabilidad abarca:

• Gestión de identidad y acceso (funciones, perfiles, conjuntos de permisos, MFA, SSO, OAuth)
• Regulación 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 de agentes: Cuando los agentes actúan de forma autónoma, los requisitos Trust se amplían a la regulación de lo que se permite a los agentes hacer, la auditoría de lo que han hecho y la seguridad de los límites de agente a plataforma (Tela de agente, Capa Einstein Trust). 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 ampliación bajo demanda inesperada. La fiabilidad requiere comprender las garantías de la plataforma (infraestructuras 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 colocable 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 de agentes: Los sistemas dirigidos por agentes presentan 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 de negocio requieren previsibilidad. Consulte Fiabilidad de compañía.

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

Construya una observabilidad integral en su solución y gestione la misma a través de procedimientos y automatización bien definidos. Operational Excellence abarca:

• Observabilidad (Monitoreo 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 de llamadas, autopsias sin culpa)
• Mejora continua (mediciones DORA, revisiones operativas)

Para Soluciones de 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 monitoreo y ajuste (incluyendo Rastreo de sesiones Agentforce para visibilidad de interacciones de extremo a extremo). Consulte Agentic Enterprise Operational Excellence.

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

Devuelva el máximo valor de negocio para cada dólar y cada unidad de recurso de plataforma, a través del uso eficiente de lo que tiene y la inversión deliberada en lo que compra. En el lado de los recursos, 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 del sesgo de datos. Por el lado del costo, significa modelado de TCO integral en costos directos (implementación, operación, mantenimiento) y costos indirectos (deuda técnica, gastos generales de gobernanza) que a menudo superan los costos 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 paquetes desbloqueados, que son tipos de empaquetado de segunda generación, composición LWC)
• Gestión del ciclo de vida de los datos (estrategias de archivo, optimización de flujos)
• Herramientas de monitoreo de desempeño (Centro de escala, Herramienta de plan de consulta, ApexGuru, Salesforce Code Analyzer)
• Análisis de creación frente a compra (evaluación de AgentExchange)
• Optimización de licencias y entornos sandbox
• Monitoreo y gobernanza de costos (tableros, controles de presupuesto, modelos de devolución frente a devolución de cargos)

Para Soluciones de 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 presentan costos 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 de agentes (AWU) miden los agentes de trabajo que se completan actualmente (tareas discretas realizadas) en vez del consumo de tokens sin procesar. Consulte Optimización de costos y recursos de negocio de agencia.

Para obtener más información, consulte Pilar de optimización de recursos y costos y Optimización de recursos y costos de negocio de agencia.

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 central, escáner sfdx)
• Patrones de no discriminación (OWD, reglas de colaboración, FLS con Monitoreo 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 de agentes: Cuando los agentes toman decisiones autónomas que afectan a las personas, lo que está en juego es la equidad. La capacidad de explicación (comprensión de por qué actuó un agente), la capacidad de impugnación (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 compañía.

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

• Controles Trust más sólidos (cifrado, registro de auditoría) consumen más recursos y agregan costos (Optimización de recursos y costos) y agregan latencia que afecta a la fiabilidad
• Mayor fiabilidad (redundancia, multirregión) aumenta el costo (Optimización de recursos y costos) y la complejidad operativa (Excelencia operativa)
• Una aplicación más integral de la equidad (supervisión humana, monitoreo de sesgos) ralentiza el rendimiento de los agentes (Optimización de recursos y costos)
• 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, es alcanzar el perfil de calidad correcto para los requisitos, la tolerancia al riesgo y el contexto de negocio de una solución concreta.

Comparta sus comentarios sobre el Marco de trabajo bien diseñado.