Del prototipo a un asistente de cara al visitante

El lanzamiento necesita más que una demostración. Termina con un widget, presupuesto, límites de acceso y un proceso de mantenimiento.

Estos pasos se refieren a las características identificadas en el código de la aplicación. Este material no ha sido validado en una instancia en vivo; consulta la documentación y las opciones de tu versión.

Cómo funciona, paso a paso

Comprobar el acceso antes de su uso.

Los servidores y la capa de datos deben hacer cumplir los permisos. No permita que el modelo decida si un usuario puede ver un documento. Filtre las fuentes antes de que entren en contexto, no después de generar la respuesta. Utilice credenciales de acceso mínimo, manténgalas alejadas de mensajes, capturas de pantalla y códigos del navegador, y rote las claves expuestas. Una lista de dominios permitidos de widget no reemplaza la autenticación API. La autenticación le identifica; La autorización determina las operaciones y los datos que puede utilizar. Pruebe también el acceso denegado.

Los errores necesitan rutas explícitas

Un tiempo de espera difiere de un error de permiso. Reintente solo errores transitorios, con intentos limitados y retrasos crecientes. Una operación con efectos secundarios puede ejecutarse antes de que se pierda su respuesta; volver a intentarlo sin una clave de idempotencia puede duplicar el efecto. La transmisión muestra el progreso pero no garantiza su finalización. Los puntos de control pueden permitir que las etapas fallidas se reanuden dentro de los límites de tiempo de ejecución. Almacene el identificador de ejecución, la etapa, la duración y el error mientras elimina los secretos de los registros. Mida trayectorias lentas y promedios.

El costo pertenece a todo el camino.

Cuente llamadas de modelos, tokens de entrada y salida, incorporaciones, reclasificación, visión y herramientas. El razonamiento puede consumir tokens facturables sin una respuesta visible igualmente larga. Los costos de indexación y los costos de conversación difieren. Utilice precios actuales en lugar de un número permanente de un curso. Una estimación simple es tokens/1.000.000 × precio más operaciones adicionales; Los créditos de la aplicación pueden tener su propia conversión. Compare el costo por tarea exitosa, no solo por llamada. La ejecución paralela puede reducir la latencia y al mismo tiempo aumentar el consumo total. Un presupuesto necesita una condición de parada verificada.

El esquema explicativo

Siga las flechas sólidas para el flujo principal. Las flechas azules discontinuas proporcionan datos o contexto; Las flechas discontinuas de color rosa muestran comentarios o resultados devueltos. Colores y formas distinguen modelos, tiendas, decisiones y resultados. En pantallas pequeñas, desplázate horizontalmente para seguir todo el esquema.

Un ejemplo completo

El widget indica su función, se ejecuta en dominios permitidos y utiliza un objetivo probado. Verifique fuentes, errores, dispositivos móviles y costos, luego defina quién revisa las políticas.

Pruébalo tú mismo

1. Complete las comprobaciones de acceso, calidad, dominio, dispositivos móviles, presupuesto y mantenimiento antes de publicar.
2. Registre la entrada, la fuente y el resultado esperado antes de ejecutar el experimento. Utilice únicamente los datos ficticios del ejemplo.
3. Siga las etapas del diagrama. En cada paso registre qué información se recibe y se produce; No confunda el resultado intermedio con el resultado final.
4. Repita después de eliminar la información necesaria o hacer que la entrada sea ambigua. Compruebe si el sistema aclara, detiene o inventa una respuesta.
5. Comparar con la solución explicada. Conserve la configuración, fecha, resultado y una explicación de las diferencias. Cambie una cosa y vuelva a probar.

Una solución explicada

Entregue integración, pruebas permitidas/denegadas, criterios de lanzamiento y una fecha de revisión. Un ejercicio exitoso le permite mostrar la conexión entre los aportes, las etapas y el resultado. Cuando falta información, una respuesta cautelosa es más útil que detalles inventados. Compare más que estilo: compruebe también las condiciones, las fuentes y las operaciones.

Cuándo resulta útil y cuáles son sus límites

No prometa a los visitantes funciones de programación o aprobación no confirmadas. Elija este enfoque cuando mejore una necesidad medida. Mantenga una línea de base simple y compare los resultados utilizando insumos idénticos. Un ejemplo exitoso no establece confiabilidad en todas las situaciones.

Comprueba lo que has aprendido

¿Por qué eliminar una fuente privada después de responder es demasiado tarde?

Los datos ya han entrado en el contexto del modelo y pueden divulgarse.

¿Un tiempo de espera prueba que la operación no se ejecutó?

No. Verifique el estado antes de volver a intentar una acción con efectos secundarios.

¿Qué resultado debería producir este ejercicio?

Entregue integración, pruebas permitidas/denegadas, criterios de lanzamiento y una fecha de revisión.

Términos que conviene recordar

• Autorizar / Autorización: Comprobar el derecho de acceso a una operación o recurso.
• Idempotencia: Repetición controlada sin duplicar un efecto.
• Latență / Latencia: Tiempo hasta un resultado útil.

Fuentes y su próximo paso

• OWASP — Inyección de instrucciones
• LangGraph — Flujos de trabajo y agentes
• OpenRouter — tokens de razonamiento

Para preparar: A03 — Un agente conectado al conocimiento · R03 — Naive RAG: tu línea de base · D04 — Buenas preguntas para probar RAG · U02 — Patio de juegos como laboratorio · U05: un widget de IA en su sitio web · E05 — Tokens, créditos, presupuestos y coste total · S01: inyección rápida y datos no confiables · S02 — Permisos y protección de datos