1. Separar los tres cambios
El protocolo, los informes de gestión y la inferencia merecen decisiones de publicación separadas. Unirlos en una actualización dificulta explicar los fallos.
| Fecha oficial | Actualización verificada | Fuente |
|---|---|---|
| 21 de octubre | Nueva versión de API y versiones principales de SDK que la utilizan por defecto. | Guía de migración |
| 29 de octubre | API de análisis de uso y costes en beta; los informes anteriores siguen admitidos. | Notas de versión |
| 30 de octubre | Fast Mode de Opus 4.8 obsoleto; retirada el 30 de noviembre. Continuar con Fast Mode exige migrar a Opus 5.5. | Aviso de retirada |
2. Revisar el SDK y el protocolo por separado
La nueva versión de API rechaza temperature, top_p y top_k. Las claves API del SDK pasan a Authorization: Bearer; la API sigue aceptando X-Api-Key. Consulta la guía y las excepciones de plataforma.
Recomendamos registrar conjuntamente dependencia instalada, cabecera de versión efectiva, cuerpo serializado y ruta de autenticación. Clientes compartidos, proxies y reintentos pueden añadir campos ausentes del código de negocio. Centraliza la adaptación para poder inspeccionar los detalles del proveedor.
Incluye conversaciones guardadas y anonimizadas. Un saludo no revela si adjuntos, citas o resultados de herramientas se transforman mal al reenviarlos. Conserva el resultado de negocio esperado junto al formato de cada caso de prueba.
3. Asignar un responsable a cada fallo
Este marco de aceptación es una propuesta de ingeniería, no un resultado de pruebas del proveedor.
| Área | Prueba | Condición de aceptación |
|---|---|---|
| Protocolo | Texto e historiales con herramientas. | La API acepta solicitudes y el analizador interpreta respuestas. |
| Gateway | Credenciales válidas, caducadas y ausentes. | Acceso esperado y ningún valor de credencial en registros. |
| Recuperación | Espera agotada, límites e interrupción del flujo. | Reintentos limitados; las herramientas con efectos externos se ejecutan una vez. |
| Reversión | Restaurar la configuración anterior completa. | Versión, adaptador y analizador vuelven juntos. |
Asigna responsables del gateway, la aplicación y los informes antes del despliegue. Un error de autenticación puede confundirse con falta de fiabilidad del modelo; un fallo de análisis, con una regresión de calidad.
4. Separar presupuestos operativos y conciliación
Los importes analíticos son cadenas decimales en centavos. Los datos suelen actualizarse en cuatro horas y pueden tardar veinticuatro. Unidades y actualización oficiales.
Por ello, controla las tareas activas mediante presupuestos y límites de solicitudes de la aplicación. Recoge los informes históricos por separado para conciliar. Una diferencia es un motivo para investigar, no prueba inmediata de cargos ausentes.
Conserva unidades y precisión originales y convierte al mostrar. Registra cada intervalo y la actualización observada. Comprueba límites temporales, retrasos y duplicados antes de interpretar discrepancias. Relaciona cada tarea con modelo, duración, reintentos y estimación local de uso para contextualizar el gasto.
5. Evitar recuentos duplicados en observabilidad
OpenTelemetry de Claude sigue en beta. Los spans de SDK y API pueden describir la misma solicitud; elige una capa de recuento y elimina duplicados. Reglas oficiales.
Utiliza un identificador de tarea para unir solicitudes y resultados de herramientas y conserva identificadores de solicitud separados. Mide éxito, duración completa y coste total. Los intentos fallidos consumen recursos; contar solo respuestas exitosas oculta el coste de un flujo inestable.
Proponemos dividir el coste de todos los intentos entre las tareas verificadas de forma independiente. El verificador debe inspeccionar el artefacto o cambio de estado requerido. El éxito HTTP no acredita una tarea terminada. Interpreta la métrica tras recoger una muestra representativa.
6. Gestionar Fast Mode como un cambio independiente
Inventaría combinaciones de modelo y velocidad frente al plazo de retirada indicado. Cambiar el modelo puede alterar las salidas; cambiar la velocidad puede alterar la latencia. Valida la alternativa elegida frente a ambos requisitos.
Mantén configuraciones auditables y asigna caducidad a las rutas de recuperación. Una configuración cuya retirada está programada solo aporta recuperación temporal. Prepara una alternativa validada con tareas representativas antes de que desaparezca esa capacidad.
7. Aplicar un plan de aceptación gradual
- Fija dependencias y configuración. Recoge casos anonimizados de texto, adjuntos, herramientas y conversaciones largas con condiciones explícitas.
- Prueba protocolo y gateway aisladamente. Separa rechazos esperados de fallos imprevistos.
- Compara configuraciones antigua y nueva con las mismas tareas y permisos. Registra fallos, reintentos y reparación humana.
- Empieza con tareas reversibles. Amplía tras revisar resultados y aplica condiciones de reversión predefinidas ante errores de autenticación, pérdida de calidad o costes inexplicados.
- Concilia los totales cuando se actualicen los informes. Explica diferencias y conserva evidencia antes de declarar completada la migración.
El plan requiere pruebas de carga de trabajo. Compatibilidad, resultados verificados y costes conciliados permiten justificar una actualización; el anuncio por sí solo no acredita esos resultados en tu aplicación.