Advanced route · updated October 2026Ruta avanzada · actualizada en octubre de 2026

Make your AI software safe to operate.Haz que tu software de IA se pueda operar con seguridad.

Cloud platforms are execution environments. The durable skill is a process that stays reviewable, testable, observable, and reversible as the code, team, and traffic change.Las nubes son entornos de ejecución. La habilidad duradera es un proceso que sigue siendo revisable, comprobable, observable y reversible cuando cambian el código, el equipo y el tráfico.

Start with the workload and failure model. Pick a provider after you can name the user journey, interface, evidence, rollback, and owner.Empieza con la carga y el modelo de fallos. Elige proveedor después de nombrar el recorrido del usuario, la interfaz, la evidencia, la reversión y el responsable.

01 · Core concepts01 · Conceptos base

Engineering is a time scale.La ingeniería escala en el tiempo.

Software Engineering at Google frames engineering as programming integrated over time and scale. That means choices about interfaces, people, tests, tools, and operations are part of the product—not paperwork around it.Software Engineering at Google presenta la ingeniería como programación integrada a través del tiempo y la escala. Por eso las decisiones sobre interfaces, personas, pruebas, herramientas y operaciones son parte del producto, no papeleo externo.

Trade-offsCompensaciones

Name the choiceNombra la decisión

Every design trades speed, safety, cost, simplicity, and future change. Record the reason and the boundary so the next person can revise it deliberately.Cada diseño intercambia velocidad, seguridad, coste, simplicidad y cambio futuro. Registra la razón y el límite para que la siguiente persona pueda revisarlo con intención.

API

Treat contracts as realTrata los contratos como reales

An interface is more than a type. Hyrum’s Law is a warning that users eventually depend on every observable behavior, even accidental behavior; change it with evidence and compatibility in mind.Una interfaz es más que un tipo. La ley de Hyrum advierte que los usuarios acabarán dependiendo de cada comportamiento observable, incluso el accidental; cambia con evidencia y compatibilidad.

Source of truthFuente de verdad

Make change legibleHaz legible el cambio

Keep source in version control. Use small reviewed changes, clear ownership, documentation, runbooks, and a trail from commit to release. Chat context is not release evidence.Mantén el código en control de versiones. Usa cambios pequeños revisados, responsables claros, documentación, guías operativas (runbooks) y un rastro del commit a la publicación. El chat no es evidencia de release.

ConfidenceConfianza

Layer trustworthy testsEstratifica pruebas confiables

Fast unit checks catch local mistakes; integration and end-to-end checks protect contracts and user journeys. Test behavior, keep CI fast, and investigate flakes instead of normalizing them.Las pruebas unitarias rápidas detectan errores locales; integración y extremo a extremo protegen contratos y recorridos. Prueba comportamiento, mantén CI rápido e investiga los fallos intermitentes.

Release shapeForma de la versión

Build a reproducible candidateConstruye un candidato reproducible

Pin dependencies, separate configuration from code, produce the same artifact in automation, and deliver continuously behind a human approval and a reversible change.Fija dependencias, separa configuración y código, produce el mismo artefacto en automatización y entrega continuamente detrás de una aprobación humana y un cambio reversible.

ReachAlcance

Serve the hard-to-serve userSirve al usuario difícil

Check keyboard flow, contrast, language, mobile width, latency, errors, and recovery. Accessibility and localization are quality signals, not polish at the end.Comprueba teclado, contraste, idioma, ancho móvil, latencia, errores y recuperación. Accesibilidad y localización son señales de calidad, no pulido final.

A useful ruleUna regla útilAutomate repeatable work; keep judgment at the boundary where the blast radius changes.Automatiza el trabajo repetible; conserva el juicio en el límite donde cambia el radio de impacto.

Learner evidenceEvidencia del alumnoA one-page change note with owner, contract, tests, release candidate, approval, and rollback trigger.Una nota de cambio de una página con responsable, contrato, pruebas, candidato, aprobación y disparador de rollback.

02 · System thinking02 · Pensamiento sistémico

Code is one node.El código es un nodo.

A deployed AI feature is a chain of contracts and failure modes. Draw the request path before choosing a cloud product, then put delivery, security, and observability around it.Una función de IA publicada es una cadena de contratos y modos de fallo. Dibuja la ruta antes de elegir un producto de nube y coloca entrega, seguridad y observabilidad alrededor.

Ask at every boundaryPregunta en cada límiteWhat crosses here? Who owns it? How do we detect a bad change? What happens when the dependency is slow or absent?¿Qué cruza aquí? ¿Quién lo mantiene? ¿Cómo detectamos un cambio malo? ¿Qué pasa si la dependencia es lenta o no está?

First labPrimer laboratorioTrace one request from browser to model and back. Mark the interface, secret boundary, timeout, log signal, and safe fallback.Traza una petición del navegador al modelo y de vuelta. Marca la interfaz, el límite de secretos, el tiempo de espera, la señal de registro y una alternativa segura.

03 · Delivery loop03 · Ciclo de entrega

Ship in evidence.Publica con evidencia.

A mature delivery loop makes the next safe decision obvious. Each stage leaves a small artifact that another person can inspect.Un ciclo maduro hace obvia la siguiente decisión segura. Cada etapa deja un artefacto pequeño que otra persona puede inspeccionar.

01

DefineDefinir

Name user, outcome, owner, boundary, and acceptance.Nombra usuario, resultado, responsable, límite y aceptación.

Evidence: change noteEvidencia: nota
02

ChangeCambiar

Make the smallest coherent version-controlled change.Haz el cambio coherente más pequeño en control de versiones.

Evidence: commitEvidencia: commit
03

ReviewRevisar

Check contract, risk, accessibility, and rollback.Revisa contrato, riesgo, accesibilidad y reversión.

Evidence: approved diffEvidencia: cambio aprobado
04

Test / buildProbar / compilar

Run layered tests and produce a reproducible candidate.Ejecuta pruebas estratificadas y produce un candidato reproducible.

Evidence: CI resultEvidencia: resultado CI
05

PreviewPrevisualizar

Try the real route with safe data and a named revision.Prueba la ruta real con datos seguros y una revisión nombrada.

Evidence: preview URLEvidencia: URL de previsualización
06

DeployPublicar

Promote through an approval gate with secrets bound at runtime.Promueve tras aprobación con secretos ligados en ejecución.

Evidence: revisionEvidencia: revisión
07

Verify / observeVerificar / observar

Check health, errors, latency, traces, and the user journey.Comprueba salud, errores, latencia, trazas y recorrido.

Evidence: signal checkEvidencia: señales
08

Promote / rollbackPromover / rollback

Use a canary or staged release; reverse on a known trigger.Usa canary o fases; revierte con un disparador conocido.

Evidence: decisionEvidencia: decisión
09

LearnAprender

Update the runbook, test, or design from what happened.Actualiza runbook, prueba o diseño a partir de lo ocurrido.

Evidence: follow-upEvidencia: seguimiento
04 · Reliability04 · Fiabilidad

Measure what users feel.Mide lo que sienten los usuarios.

Reliability is not a claim; it is a feedback system. Connect one journey to an SLI, choose an SLO, and use the error budget to decide how much change the service can safely absorb.La fiabilidad no es una promesa; es un sistema de feedback. Conecta un recorrido con un SLI, elige un SLO y usa el presupuesto de errores para decidir cuánto cambio puede absorber el servicio.

01

JourneyRecorrido

“A user can upload a file and receive a useful answer.”«Un usuario puede subir un archivo y recibir una respuesta útil».

02

SLI → SLO

Measure successful answers and latency; set a target that represents user value.Mide respuestas exitosas y latencia; fija un objetivo que represente valor.

03

Error budgetPresupuesto de errores

The allowed miss is a change budget, not permission to harm users.El fallo permitido es un presupuesto de cambio, no permiso para dañar usuarios.

04

Signals → actionSeñales → acción

Health, errors, latency, logs, metrics, and traces tell you when to pause, rollback, or improve.Salud, errores, latencia, logs, métricas y trazas indican cuándo pausar, revertir o mejorar.

Safe releaseRelease seguro

Canary is a questionUn canary es una pregunta

Send a small share of traffic to a new revision, compare its signals with the baseline, and define the promotion or rollback decision before starting.Envía poco tráfico a una revisión, compara sus señales con la base y define promoción o rollback antes de empezar.

IncidentIncidente

Restore, then learnRestaura y aprende

Respond with roles, a communication path, and a reversible action. A blameless-but-accountable postmortem names contributing conditions and changes the system.Responde con roles, comunicación y una acción reversible. Un postmortem sin culpas pero con responsabilidad nombra condiciones y cambia el sistema.

Team healthSalud del equipo

Reduce toilReduce el trabajo repetitivo

Automate repetitive operational work so people can improve the service. Use DORA measures as team trend feedback, never as an individual quota.Automatiza trabajo operativo repetitivo para mejorar el servicio. Usa métricas DORA como tendencia del equipo, nunca como cuota individual.

05 · Workload chooser05 · Selector de carga

Choose the failure model.Elige el modelo de fallos.

Provider comes after workload. Start with request shape, state, latency, scale, background work, and recovery. Then pick the smallest runtime that makes those properties explicit.El proveedor viene después de la carga. Empieza por la forma de la petición, el estado, la latencia, la escala, el trabajo en segundo plano y la recuperación. Luego elige el entorno de ejecución más pequeño que haga explícitas esas propiedades.

Static frontendFrontend estático

Assets, docs, client-rendered UI.Assets, docs, UI en cliente.

Edge hosting + cacheHosting edge + caché

Full-stack webWeb full-stack

Routes, forms, auth, data access.Rutas, formularios, auth y datos.

Managed web runtimeRuntime web gestionado

API / functionAPI / función

Short request, clear boundary, bursty load.Petición corta, límite claro, picos.

Function or workerFunction o worker

Request containerContenedor de peticiones

Custom process, repeatable image, HTTP.Proceso propio, imagen repetible, HTTP.

Managed containerContenedor gestionado

Background workflowFlujo en segundo plano

Retries, pauses, schedules, durable steps.Reintentos, pausas, horarios, pasos durables.

Job or workflow engineJob o motor de workflows

Stateful / dataEstado / datos

Durable state, schema, backup, migration.Estado durable, esquema, backup, migración.

Managed storage firstAlmacenamiento gestionado

VM / serverVM / servidor

OS control, long-lived process, learning lane.Control del SO, proceso largo, aprendizaje.

Own the patching boundaryMantén el límite de parches

06 · Delivery stack06 · Stack de entrega

Learn one delivery spine.Aprende una sola columna de entrega.

Tools change; these six jobs stay. Start with the smallest path that leaves reviewable evidence, then add infrastructure, orchestration, or agent tooling only when the workload creates the need.Las herramientas cambian; estos seis trabajos permanecen. Empieza con la ruta más pequeña que deje evidencia revisable y añade infraestructura, orquestación o agentes solo cuando la carga lo exija.

01

Source + reviewCódigo + revisión

GitHub, GitLab, or Azure Repos keeps the change, discussion, owner, and approval together.GitHub, GitLab o Azure Repos reúne cambio, conversación, responsable y aprobación.

Proof: approved changePrueba: cambio aprobado
02

Test + buildProbar + compilar

Actions, GitLab CI/CD, Azure Pipelines, or provider build services repeat the checks.Actions, GitLab CI/CD, Azure Pipelines o servicios cloud repiten las comprobaciones.

Proof: CI resultPrueba: resultado CI
03

Package + recordEmpaquetar + registrar

Create one versioned artifact or container and record its immutable digest.Crea un artefacto o contenedor versionado y registra su digest inmutable.

Proof: artifact digestPrueba: digest
04

Run + releaseEjecutar + publicar

Promote that artifact to a managed function or container before reaching for Kubernetes.Promueve el mismo artefacto a una función o contenedor gestionado antes de usar Kubernetes.

Proof: named revisionPrueba: revisión
05

Observe + evaluateObservar + evaluar

Connect logs, metrics, traces, health, and model or agent evaluation to the user journey.Conecta logs, métricas, trazas, salud y evaluación de modelo o agente con el recorrido.

Proof: signal checkPrueba: señales
06

Recover + learnRecuperar + aprender

Practice rollback, update the runbook, and turn an incident or failed eval into a system change.Practica rollback, actualiza el runbook y convierte un incidente o eval fallida en un cambio.

Proof: recovery drillPrueba: simulacro
MAPCommon tools by jobHerramientas comunes por trabajoOpen this catalog when a stage needs more control—not to collect every tool.Abre este catálogo cuando una etapa necesite más control, no para coleccionar herramientas.
Local boundaryLímite local

Docker and Compose make the service and its dependencies repeatable before cloud deployment.Docker y Compose hacen repetibles el servicio y sus dependencias antes del cloud.

Infrastructure as codeInfraestructura como código

Terraform or OpenTofu for a portable declarative plan; Pulumi for general-purpose languages. CDK, CloudFormation, and Bicep are provider-native options.Terraform u OpenTofu para un plan declarativo portable; Pulumi para lenguajes comunes. CDK, CloudFormation y Bicep son opciones nativas.

Containers at scaleContenedores a escala

Kubernetes and Helm add scheduling and packaging when a managed container is no longer enough.Kubernetes y Helm añaden planificación y empaquetado cuando un contenedor gestionado ya no basta.

GitOps

Argo CD or Flux reconciles Git with Kubernetes. Add one after the cluster and ownership model exist.Argo CD o Flux reconcilia Git con Kubernetes. Añádelo después de tener clúster y responsables.

Portable signalsSeñales portables

OpenTelemetry instruments the service; Prometheus and Grafana are common metrics and visualization layers. Provider observability can receive the same signals.OpenTelemetry instrumenta el servicio; Prometheus y Grafana son capas comunes de métricas y visualización. La observabilidad cloud puede recibir las mismas señales.

Identity + secretsIdentidad + secretos

Prefer workload identity and each provider’s secret manager. Vault is a cross-cloud option when centralized secret workflows justify it.Prefiere identidad de carga y el gestor de secretos del proveedor. Vault sirve entre nubes cuando justifica un flujo centralizado.

Advanced · Agent frameworksAvanzado · Frameworks de agentes

Google ADK, Microsoft Agent Framework, AWS Strands, LangGraph, LlamaIndex, and OpenAI Agents SDK can shape agent workflows. Add one only after a direct model call works; use a plain function when it is enough.Google ADK, Microsoft Agent Framework, AWS Strands, LangGraph, LlamaIndex y OpenAI Agents SDK pueden estructurar agentes. Añade uno solo cuando funcione una llamada directa al modelo; usa una función simple cuando baste.

Advanced · AI traces + evalsAvanzado · Trazas + evals de IA

Start with provider evaluations; add a focused layer such as Phoenix or Promptfoo only when the provider path cannot prove the behavior you need. Test task quality, tool use, safety, latency, and cost together.Empieza con evaluaciones del proveedor; añade una capa como Phoenix o Promptfoo solo si la ruta del proveedor no puede probar el comportamiento necesario. Prueba calidad, herramientas, seguridad, latencia y coste juntas.

Selection ruleRegla de selección

Choose one tool per job, record why, and preserve an exit path. More layers mean more upgrades, permissions, and failure modes.Elige una herramienta por trabajo, registra por qué y conserva una salida. Más capas implican más actualizaciones, permisos y fallos.

Recheck access and retentionRevisa acceso y retención

Cloudflare now offers Worker-specific roles: metadata reader, code reader, editor, and admin. Give deployment access only where needed. Vercel began deleting deployments beyond the retention window on October 23 unless teams opted out. Inspect retained releases now and rehearse rollback to an artifact that still exists.Cloudflare ofrece roles por Worker: lector de metadatos, lector de código, editor y administrador. Limita el acceso de despliegue. Vercel empezó a eliminar despliegues fuera de la retención el 23 de octubre salvo exclusión configurada. Inspecciona versiones conservadas y ensaya rollback a un artefacto que aún exista. Cloudflare ↗ · Vercel ↗

07 · Platform lanes07 · Carriles de plataforma

Map the same jobs.Mapea los mismos trabajos.

These are implementations of the delivery spine, not a ranking. Scan the map, then open one lane for its developer workflow, AI layer, delivery path, runtime, identity, signals, and first proof.Son implementaciones de la columna de entrega, no un ranking. Revisa el mapa y abre un carril para su flujo, capa de IA, entrega, runtime, identidad, señales y primera prueba.

Equivalent delivery jobs across AWS, Google Cloud, and MicrosoftTrabajos de entrega equivalentes en AWS, Google Cloud y Microsoft
ProviderProveedorBuild AICrear IABuild + promoteCompilar + promoverArtifact + runtimeArtefacto + runtimeIdentity + secretsIdentidad + secretosObserve + evaluateObservar + evaluarRecover + rollbackRecuperar + revertir
AWSBedrock · SageMaker AI · AgentCoreCodeConnections → CodePipeline · CodeBuildECR → Lambda · ECS · EKSIAM roles · Secrets ManagerCloudWatch · Application Signals · ADOTECS deployment rollback · Lambda alias/version rollback
Google CloudAI Studio · Gemini API → Agent Studio · Agent Runtime · EvalsCloud Build → Cloud DeployArtifact Registry → Cloud Run · GKEIAM service identity · Secret ManagerCloud Observability · OpenTelemetryCloud Deploy rollback · Cloud Run revisions
MicrosoftFoundry · Agent Service · Agent FrameworkGitHub Actions or Azure PipelinesACR → Container Apps · Functions · AKSEntra managed identity · Key VaultAzure Monitor · Application Insights · OpenTelemetryContainer Apps revisions · prior image

Scroll the map on a small screen. The equivalent job matters more than identical product boundaries.Desplaza el mapa en pantalla pequeña. Importa el trabajo equivalente, no que los límites de producto sean idénticos.

AWSAmazon Web ServicesMove from assisted development to a grounded AI service, a reproducible pipeline, and an observable runtime.Pasa del desarrollo asistido a un servicio de IA fundamentado, un pipeline reproducible y un runtime observable.
Developer workflowFlujo del desarrollador

Amazon Q Developer assists with AWS and application work. Kiro adds a spec-driven IDE and CLI for agentic coding. Keep repository review and CI as the source of release evidence.Amazon Q Developer ayuda con AWS y aplicaciones. Kiro añade IDE y CLI guiados por especificaciones para desarrollo agéntico. Conserva revisión y CI como evidencia.

Build AICrear IA

Bedrock supplies managed models, Knowledge Bases, Guardrails, and evaluation. Use SageMaker AI when training, tuning, or a broader ML lifecycle is the job; use AgentCore for production agent services. At organizational scale, Agent Registry provides a governed catalog for agents, tools, skills, MCP servers, and custom resources.Bedrock aporta modelos, Knowledge Bases, Guardrails y evaluación. Usa SageMaker AI cuando el trabajo sea entrenamiento, ajuste o un ciclo ML más amplio; usa AgentCore para servicios de agentes en producción. A escala organizacional, Agent Registry ofrece un catálogo gobernado de agentes, herramientas, skills, servidores MCP y recursos personalizados.

What to verify nowQué verificar ahora

AgentCore Gateway now supports ordered model fallback and native Bedrock InvokeModel traffic across inference targets. Define which errors and timeouts trigger fallback; test the backup model’s tool format and data boundary. Interactive harness shells remain a separate WebSocket execution capability.AgentCore Gateway admite fallback ordenado de modelos y tráfico nativo Bedrock InvokeModel entre destinos de inferencia. Define errores y timeouts que activan fallback; prueba formato de herramientas y límite de datos del modelo alternativo. Los shells interactivos del harness siguen como capacidad de ejecución WebSocket separada. Official update ↗Actualización oficial ↗

DeliverEntregar

Connect GitHub, GitLab, or Azure DevOps through CodeConnections, then let CodePipeline coordinate CodeBuild, approval, and promotion.Conecta GitHub, GitLab o Azure DevOps mediante CodeConnections y deja que CodePipeline coordine CodeBuild, aprobación y promoción.

Artifact + runtimeArtefacto + runtime

Store images in ECR. Start with Lambda for events or ECS Express Mode for a request container; move to ECS/Fargate for control and EKS only when Kubernetes is justified. Amplify and Lightsail remain simpler web lanes.Guarda imágenes en ECR. Empieza con Lambda para eventos o ECS Express Mode para un contenedor; pasa a ECS/Fargate por control y a EKS solo si Kubernetes se justifica. Amplify y Lightsail siguen siendo rutas simples.

Identity + secretsIdentidad + secretos

Use IAM roles and temporary credentials for people, CI, and workloads. Bind the narrowest permissions and retrieve runtime secrets from Secrets Manager.Usa roles IAM y credenciales temporales para personas, CI y cargas. Liga los permisos mínimos y recupera secretos en ejecución desde Secrets Manager.

Observe + evaluateObservar + evaluar

Use CloudWatch logs, metrics, and Application Signals with ADOT/OpenTelemetry. Pair service signals with Bedrock or AgentCore evaluations; prefer OpenTelemetry over starting new work on the X-Ray SDK or daemon.Usa logs, métricas y Application Signals de CloudWatch con ADOT/OpenTelemetry. Une señales con evaluaciones de Bedrock o AgentCore; prefiere OpenTelemetry al SDK o daemon de X-Ray para trabajo nuevo.

First lab + proofPrimer lab + prueba

Build a grounded API over a small non-sensitive Knowledge Base, test answers and citations, containerize it, promote ECR to ECS Express Mode, inspect traces, and prove rollback. Save the eval set, image digest, IAM boundary, revision, and signal check.Crea una API fundamentada sobre una Knowledge Base pequeña y no sensible, prueba respuestas y citas, crea el contenedor, promueve de ECR a ECS Express Mode, revisa trazas y demuestra rollback. Guarda eval, digest, IAM, revisión y señales.

Current boundariesLímites actuales

Do not begin a new path with App Runner, CodeCatalyst, or Bedrock Agents Classic: current AWS availability guidance points new work elsewhere. Verify region support before committing to an architecture.No inicies una ruta nueva con App Runner, CodeCatalyst o Bedrock Agents Classic: la guía actual de AWS dirige el trabajo nuevo a otros productos. Verifica regiones antes de decidir arquitectura.

GCPGoogle CloudPrototype with Gemini, then promote the same service through managed delivery, identity, evaluation, and rollback.Prototipa con Gemini y luego promueve el mismo servicio con entrega gestionada, identidad, evaluación y rollback.
Developer workflowFlujo del desarrollador

Use Google AI Studio and the Gemini API for a fast prototype. Cloud Code supports Cloud Run and GKE work; Gemini Code Assist Standard and Enterprise integrate assistance for teams. The former individual Gemini CLI path now points to Antigravity CLI.Usa Google AI Studio y Gemini API para prototipos rápidos. Cloud Code apoya Cloud Run y GKE; Gemini Code Assist Standard y Enterprise integran ayuda para equipos. La antigua ruta individual de Gemini CLI ahora apunta a Antigravity CLI.

Build AICrear IA

For managed enterprise AI, the current portfolio is Gemini Enterprise Agent Platform: Agent Studio, Agent Runtime, Agent Search, and Evals. Gemini Enterprise is the employee-facing application; it is not the same boundary as the developer platform.Para IA empresarial gestionada, el portafolio actual es Gemini Enterprise Agent Platform: Agent Studio, Agent Runtime, Agent Search y Evals. Gemini Enterprise es la aplicación para empleados, no el mismo límite que la plataforma de desarrollo.

What to verify nowQué verificar ahora

Computer Use and Shell sandboxes are generally available. Semantic governance now covers more model providers, but not streamed responses. Keep user-intent matching enabled unless your threat model justifies changing it, and verify denial logs. For Gemini Enterprise apps, pair a gateway with one registry in the same project and region.Los sandboxes Computer Use y Shell están disponibles de forma general. La gobernanza semántica cubre más proveedores, pero no respuestas en streaming. Mantén activa la comprobación de intención salvo una justificación basada en amenazas y verifica logs de denegación. En apps Gemini Enterprise, vincula el gateway a un registro en el mismo proyecto y región. Official update ↗Actualización oficial ↗

DeliverEntregar

Let Cloud Build test and package, Artifact Registry hold the candidate, and Cloud Deploy promote a reviewed release to Cloud Run or GKE with an explicit rollback target.Deja que Cloud Build pruebe y empaquete, Artifact Registry guarde el candidato y Cloud Deploy promueva una versión revisada a Cloud Run o GKE con rollback explícito.

Artifact + runtimeArtefacto + runtime

Start with Cloud Run for HTTP, Cloud Run Jobs for finite background work, or Functions for event-driven code. Use GKE Autopilot before Standard when Kubernetes is required; Firebase App Hosting remains a Git-connected framework lane.Empieza con Cloud Run para HTTP, Cloud Run Jobs para trabajo finito o Functions para eventos. Usa GKE Autopilot antes de Standard si necesitas Kubernetes; Firebase App Hosting sigue como ruta de frameworks conectada a Git.

Identity + secretsIdentidad + secretos

Run the service as a dedicated IAM service identity, keep it private by default, grant narrow resource access, and fetch runtime configuration from Secret Manager.Ejecuta el servicio con una identidad IAM dedicada, privado por defecto, concede acceso mínimo y recupera configuración en ejecución desde Secret Manager.

Observe + evaluateObservar + evaluar

Connect Cloud Monitoring, Logging, and Trace through Google Cloud Observability and OpenTelemetry. Evaluate structured answers or agent tasks before promotion, then watch user-facing health and latency.Conecta Cloud Monitoring, Logging y Trace mediante Google Cloud Observability y OpenTelemetry. Evalúa respuestas estructuradas o tareas de agente antes de promover y vigila salud y latencia.

First lab + proofPrimer lab + prueba

Build a structured-output Gemini API, keep the Cloud Run service private, bind one service identity and secret, then promote it with Cloud Build, Artifact Registry, and Cloud Deploy. Save eval results, revision, trace, health check, and rollback evidence.Crea una API Gemini con salida estructurada, mantén Cloud Run privado, liga una identidad y un secreto y promuévela con Cloud Build, Artifact Registry y Cloud Deploy. Guarda evals, revisión, traza, salud y rollback.

Current namingNombres actuales

Recent documentation renamed Vertex AI Platform to Gemini Enterprise Agent Platform and Vertex AI Studio to Agent Studio. Older Vertex AI terms still appear; use Google’s name-change map rather than assuming every Vertex AI service was renamed.La documentación reciente renombró Vertex AI Platform como Gemini Enterprise Agent Platform y Vertex AI Studio como Agent Studio. Aún verás términos Vertex AI; usa el mapa oficial de cambios en vez de asumir que todo fue renombrado.

MSMicrosoft AzureChoose GitHub or Azure DevOps for delivery, Microsoft Foundry for AI, and Azure services for the runtime.Elige GitHub o Azure DevOps para entrega, Microsoft Foundry para IA y servicios Azure para el runtime.
Developer workflowFlujo del desarrollador

GitHub Copilot spans IDE, CLI, and cloud-agent work with pull-request review. Azure DevOps offers Boards, Repos, Pipelines, Artifacts, and Test Plans. They are overlapping ecosystems; choose the one your team can operate clearly.GitHub Copilot abarca IDE, CLI y agente cloud con revisión por pull request. Azure DevOps ofrece Boards, Repos, Pipelines, Artifacts y Test Plans. Son ecosistemas solapados; elige el que tu equipo pueda operar con claridad.

Build AICrear IA

Microsoft Foundry brings models, Foundry Tools, Agent Service, evaluation, tracing, policies, and governance together. Microsoft Agent Framework is the current successor path for Semantic Kernel and AutoGen concepts; keep simple model calls simple.Microsoft Foundry reúne modelos, Foundry Tools, Agent Service, evaluación, trazas, políticas y gobierno. Microsoft Agent Framework es la ruta sucesora para conceptos de Semantic Kernel y AutoGen; mantén simples las llamadas simples.

What to verify nowQué verificar ahora

Foundry Routines and Tool Search are generally available; Insights and long-running hosted-agent resilience remain previews. The model router offers preview session affinity and per-request routing metadata. Affinity attempts to preserve a model, but fallback can still change it. Record the actual serving model and retry path when evaluating quality, latency, and failures.Routines y Tool Search de Foundry están disponibles de forma general; Insights y la resiliencia de agentes alojados de larga duración siguen en preview. El router ofrece afinidad de sesión y metadatos por solicitud en preview. La afinidad intenta conservar el modelo, pero el fallback puede cambiarlo. Registra el modelo real y la ruta de reintentos al evaluar calidad, latencia y fallos. Official update ↗Actualización oficial ↗

DeliverEntregar

Use GitHub Actions or Azure Pipelines to test, build, approve, and promote. Store container candidates in Azure Container Registry; describe Azure-native infrastructure with Bicep or keep a portable Terraform plan.Usa GitHub Actions o Azure Pipelines para probar, compilar, aprobar y promover. Guarda contenedores en Azure Container Registry; describe infraestructura nativa con Bicep o conserva un plan Terraform portable.

Artifact + runtimeArtefacto + runtime

Start with Container Apps for a managed container, Functions Flex Consumption for event-driven work, App Service for a managed web application, or Static Web Apps for a frontend. Use AKS only when Kubernetes control is required.Empieza con Container Apps para contenedor gestionado, Functions Flex Consumption para eventos, App Service para una web gestionada o Static Web Apps para frontend. Usa AKS solo si necesitas control de Kubernetes.

Identity + secretsIdentidad + secretos

Use Microsoft Entra managed identities and role-based access so CI and workloads avoid long-lived credentials. Keep runtime secrets and keys in Key Vault, with Azure Policy guarding the boundary.Usa identidades gestionadas de Microsoft Entra y acceso por roles para evitar credenciales duraderas en CI y cargas. Guarda secretos y claves en Key Vault y protege el límite con Azure Policy.

Observe + evaluateObservar + evaluar

Connect Azure Monitor, Application Insights, Log Analytics, KQL, and OpenTelemetry. Foundry evaluations cover AI behavior; treat prompts, tool calls, and traces as potentially sensitive data.Conecta Azure Monitor, Application Insights, Log Analytics, KQL y OpenTelemetry. Las evaluaciones de Foundry cubren comportamiento de IA; trata prompts, llamadas y trazas como datos potencialmente sensibles.

First lab + proofPrimer lab + prueba

Add one structured Foundry model call to a reviewed repository, build it in CI, publish to ACR, deploy to Container Apps with managed identity and Key Vault, then inspect an Application Insights trace and roll back. Save the eval, image digest, revision, access boundary, and approval.Añade una llamada estructurada de Foundry a un repositorio revisado, compila en CI, publica en ACR, despliega en Container Apps con identidad gestionada y Key Vault, revisa una traza y revierte. Guarda eval, digest, revisión, acceso y aprobación.

Current boundariesLímites actuales

The current name is Microsoft Foundry, not Azure AI Foundry. Azure DevOps delivers work but does not host the application; Foundry supplies the AI layer but is not generic hosting. For new Functions serverless apps, start with Flex Consumption rather than the legacy Consumption plan.El nombre actual es Microsoft Foundry, no Azure AI Foundry. Azure DevOps entrega trabajo pero no aloja la app; Foundry aporta IA pero no hosting genérico. Para Functions nuevas, empieza con Flex Consumption, no el plan Consumption heredado.

VVercelA fast Git preview-to-production loop for frontend and request-serving AI features.Un ciclo rápido de preview a producción desde Git para frontend y funciones de IA.
Start hereEmpieza aquí

Connect Git, inspect preview deployments, then promote a known production revision.Conecta Git, inspecciona previews y luego promueve una revisión conocida.

Add when neededAñade cuando haga falta

Functions, the AI SDK or AI Gateway, Observability, and a practiced rollback path.Functions, AI SDK o AI Gateway, Observability y un rollback practicado.

First lab / boundaryPrimer lab / límite

Preview a streaming AI route with safe secrets, check latency and errors, then promote or revert. Treat platform limits and provider dependencies as part of the contract.Previsualiza una ruta de IA con streaming y secretos seguros, revisa latencia y errores y promueve o revierte. Trata límites y dependencias como parte del contrato.

CFCloudflareEdge-first Workers path for static assets, APIs, storage, and durable workflows.Ruta Workers edge-first para assets, APIs, almacenamiento y workflows durables.
Start hereEmpieza aquí

Workers Static Assets plus a Worker API for a small full-stack route. Pages still works, but it is not the primary new-project recommendation here.Workers Static Assets más Worker API para una ruta full-stack pequeña. Pages sigue funcionando, pero aquí no es la recomendación principal para proyectos nuevos.

Add when neededAñade cuando haga falta

D1, R2, or KV for one clear data need; Workflows for durable steps; observability and security controls. For Agents SDK model access, use createAI; workers-ai-provider and ai-gateway-provider are deprecated and feature-frozen.D1, R2 o KV para una necesidad clara; Workflows para pasos durables; observabilidad y seguridad. Para modelos con Agents SDK usa createAI; workers-ai-provider y ai-gateway-provider están obsoletos y sin nuevas funciones.

First lab / boundaryPrimer lab / límite

Deploy a static-plus-API Worker, add one binding, inspect logs, and prove an intentional rollback. Defer queues, containers, Durable Objects, Vectorize, and Agents SDK until the workload asks for them.Publica un Worker de assets más API, añade un binding, revisa logs y prueba rollback. Deja queues, containers, Durable Objects, Vectorize y Agents SDK para cuando la carga los pida.

createAI ↗

08 · Production practice08 · Práctica de producción

Operate the boundary.Opera el límite.

The delivery stack gets a service out; these controls keep its blast radius understandable. Apply the same gates in every provider lane.El stack publica el servicio; estos controles mantienen entendible su radio de impacto. Aplica las mismas barreras en cada proveedor.

Release gateBarrera de release

Separate preview and production, require a named approval, and promote the tested artifact—not a fresh rebuild.Separa preview y producción, exige aprobación identificada y promueve el artefacto probado, no otra compilación.

Workload identityIdentidad de carga

Give CI and the runtime their own narrow roles. Do not hand an agent or pipeline a broad personal credential.Da roles mínimos propios a CI y runtime. No entregues una credencial personal amplia a un agente o pipeline.

Data + trace hygieneHigiene de datos + trazas

Redact prompts, tool arguments, user data, and secrets; choose retention and access before enabling detailed AI traces.Redacta prompts, argumentos, datos y secretos; elige retención y acceso antes de activar trazas de IA detalladas.

Alert + runbookAlerta + runbook

Alert on user impact, name the owner and first action, and link the signal to rollback or a safe fallback.Alerta por impacto al usuario, nombra responsable y primera acción y conecta la señal con rollback o fallback seguro.

GOProduction readiness gateBarrera de preparaciónThree decisions to make before promotion.Tres decisiones antes de promover.
BeforeAntes

Confirm owner, user journey, dependency and data boundaries, tests, evals, capacity, access, and a known release candidate.Confirma responsable, recorrido, dependencias y datos, pruebas, evals, capacidad, acceso y candidato conocido.

TriggerDisparador

Write the health, error, latency, quality, security, or cost signal that pauses or reverses the release.Escribe la señal de salud, error, latencia, calidad, seguridad o coste que pausa o revierte.

EvidenceEvidencia

Keep the approval, artifact digest, deployment revision, signal check, rollback result, and unresolved risks together.Reúne aprobación, digest, revisión desplegada, señales, rollback y riesgos pendientes.

Least privilegeMínimos privilegios

Separate users, services, environments, and production approval. Review permissions when the system gains a tool or data source.Separa usuarios, servicios, entornos y aprobación. Revisa permisos al añadir una herramienta o fuente de datos.

Budget and cleanupPresupuesto y limpieza

Set alerts, name resources, expire previews, remove abandoned test data, and check region or runtime cost before scale.Configura alertas, nombra recursos, expira previews, elimina datos de prueba y revisa región o coste antes de escalar.

Recovery is a featureRecuperarse es una función

Back up state, plan migrations, practice rollback, and turn incident learning into a test, runbook, or design change.Respalda estado, planifica migraciones, practica rollback y convierte incidentes en prueba, runbook o cambio de diseño.

09 · Handoff09 · Entrega

Make safe operation repeatable.Haz repetible la operación segura.

This operability contract is a one-page record for the end of a lab, agent task, or release review. It keeps the proof visible without storing prompts, notes, uploads, or sensitive content.Este contrato de operación es un registro de una página para cerrar un laboratorio, una tarea de agente o una revisión. Mantiene visible la prueba sin guardar instrucciones, notas, archivos ni contenido sensible.

Copy only when you choose. Fill it with facts, links, and unresolved risks—not confidence language. The clipboard action is explicit and does not write to local storage.Copia solo cuando lo elijas. Rellénalo con hechos, enlaces y riesgos pendientes, no con lenguaje de confianza. La acción de portapapeles es explícita y no escribe en almacenamiento local.

OPERABILITY CONTRACT
Service goal:
Owner / users:
Workload / runtime decision:
Interfaces / dependencies:
Source commit / review:
Tests / CI evidence:
Deployment revision / URL:
Health / SLI / SLO:
Logs / metrics / traces:
Secrets / data boundary:
Rollout / rollback trigger:
Incident / learning:
Unresolved risks / acceptance:
10 · Primary sources10 · Fuentes primarias

Read the reasoning.Lee el razonamiento.

These official books and product docs anchor the concepts and current platform boundaries. Product names and recommendations change; verify before a real deployment.Estos libros y documentos oficiales anclan los conceptos y límites actuales. Los nombres y recomendaciones cambian; verifica antes de publicar.

SRCOpen the full source indexAbrir el índice completo de fuentesFirst-party engineering, platform, delivery, identity, observability, and evaluation documentation.Documentación primaria de ingeniería, plataforma, entrega, identidad, observabilidad y evaluación.
11 · Land or deepen11 · Llega o profundiza

A service you can operate safely is a valid destination.Un servicio que puedes operar con seguridad es un destino válido.

Stop with explicit evidence, not with a vague feeling that deployment worked. Add provider, infrastructure, or on-call depth only when the workload creates that need.Para con evidencia explícita, no con la sensación vaga de que el despliegue funcionó. Agrega profundidad de proveedor, infraestructura u on-call solo cuando la carga lo exija.