Glosario de IA Operations
¿Qué es una especificación técnica (tech spec)?
Especificación técnica (Tech Spec)
← Todos los términos del glosarioUn plano de ingeniería que describe cómo se construirá un sistema: servicios, modelo de datos, APIs, infraestructura, riesgos y plan de despliegue.
Explicación
Una especificación técnica, o tech spec, convierte lo que un sistema debe hacer en cómo se va a construir. Describe la arquitectura y los componentes, el modelo de datos, las APIs e integraciones, la infraestructura, los objetivos no funcionales como rendimiento y disponibilidad, las medidas de seguridad y el plan de migración y despliegue, junto con las alternativas que se han valorado. Se escribe antes del grueso del desarrollo para que los problemas salgan cuando todavía son baratos de arreglar y el equipo se ponga de acuerdo en un único diseño. En sistemas de IA cubre además la elección de modelo, las baterías de evaluación, las rutas de fallback y la observabilidad, para que las herramientas y los agentes que se construyen encima tengan un contrato estable.
Qué suele contener
- Contexto y objetivos, con enlace a los requisitos funcionales.
- Arquitectura propuesta: componentes, responsabilidades y cómo se relacionan.
- Modelo de datos y almacenamiento.
- APIs, eventos e integraciones con otros sistemas.
- Requisitos no funcionales: rendimiento, disponibilidad, escalabilidad y coste, a menudo como objetivos de nivel de servicio (SLO).
- Seguridad, privacidad y cumplimiento.
- Alternativas valoradas y por qué se descartaron.
- Plan de migración, despliegue, pruebas y monitorización.
- Riesgos y preguntas abiertas.
Especificación técnica y especificación funcional
La especificación funcional describe qué debe hacer el sistema desde el punto de vista del usuario y del negocio: funcionalidades, reglas y criterios de aceptación. La especificación técnica describe cómo se hará. La primera la revisan sobre todo los responsables de producto y negocio; la segunda, arquitectos e ingenieros. Las dos deben estar enlazadas, para que cada decisión de diseño responda a un requisito.
Qué cambia en los sistemas de IA
- Elección de modelo y motivo: capacidad, coste, latencia, alojamiento y residencia de los datos.
- Baterías de evaluación con los umbrales de calidad que el sistema debe superar antes de publicarse.
- Rutas de fallback cuando el modelo falla, tarda o no está seguro, incluido el paso a una persona.
- Guardrails, permisos y límites a las acciones que pueden hacer los agentes.
- Observabilidad: registro de prompts, llamadas a herramientas, coste y calidad de las respuestas.
- Cómo se versionan y se revierten prompts, modelos e índices.
Preguntas frecuentes
¿Qué es una tech spec en desarrollo de software?
Es un documento que explica cómo se va a construir una funcionalidad o un sistema: arquitectura, datos, APIs, infraestructura, riesgos y despliegue. Se escribe antes del grueso del desarrollo para que el equipo acuerde el diseño y detecte los problemas pronto.
¿Qué diferencia hay entre una especificación técnica y una funcional?
La especificación funcional dice qué debe hacer el sistema para los usuarios y el negocio. La técnica dice cómo lo va a construir ingeniería. Se complementan y deben estar enlazadas.
¿Una tech spec es lo mismo que un documento de diseño?
Son muy parecidos y muchos equipos usan los dos términos indistintamente. El documento de diseño suele centrarse en el diseño propuesto y sus compromisos; la tech spec puede incluir además contratos detallados, objetivos y planes de despliegue.
¿Quién escribe la especificación técnica?
Normalmente el ingeniero o el arquitecto que va a liderar el trabajo, con aportaciones del resto del equipo, de seguridad y de operaciones. Los responsables de producto la revisan para comprobar que cumple los requisitos.
¿Qué debe incluir una tech spec para un sistema de IA?
Además de la arquitectura, los datos y las APIs, debe recoger la elección de modelo, los criterios y umbrales de evaluación, las rutas de fallback, los guardrails y permisos, y cómo se vigilarán la calidad y el coste en producción.
Dónde aparece en Thinkia
Para seguir leyendo
Términos relacionados
Fuentes
- Malte Ubl · Design docs at Google (en inglés)
- ISO · ISO/IEC/IEEE 29148:2018 Requirements engineering (en inglés)
- ISO · ISO/IEC/IEEE 42010:2022 Architecture description (en inglés)
Actualizado: 2026-10-21