# Guion del vídeo, para comentar o para lo que necesites. # Es una PROYECCIÓN del nuestro: lleva el contenido —qué se dice, qué se ve, en # qué orden y cuánto dura— y no la maquinaria que lo convierte en vídeo. id: herramientas-agente-que-hace title: 'La skill spidi: responde preguntas e integra pagos' audience: Desarrollador que usa Claude Code y va a integrar o consultar pagos SPIDI objetivo: > Al terminar, el espectador sabe que la skill hace dos trabajos —responder citando la documentación, e integrar cerrando el ciclo—, entiende por qué no sabe la API de memoria y qué gana con eso, conoce sus cuatro criterios duros, y sabe qué NO hace. cta: 'Siguiente: ''Instalar la skill spidi''.' target_duration_s: 235 storyboard: - 'n': 1 on_screen: El fallo no es aleatorio narracion: >- Cuando le pides a tu agente de inteligencia artificial que integre pagos, lo normal es que se invente un endpoint a mitad de camino, o que dé el trabajo por terminado en cuanto ve una respuesta correcta. La skill spidi existe para que no te pase: un paquete de criterio y procedimiento que instalas en Claude Code para que tu propio agente trabaje con SPIDI sin inventar y sin darse por aprobado a sí mismo. visual: >- Una terminal donde un agente escribe con aplomo un endpoint que no existe, con una señal de alerta discreta al lado. duracion_s: 29 - 'n': 2 on_screen: Responder · Integrar narracion: >- Y para eso hace dos trabajos, no uno. Es lo primero que conviene saber, porque mucha gente solo conoce el segundo. visual: >- Dos caminos saliendo de la misma terminal: uno hacia un signo de interrogación con un libro, otro hacia un engranaje con un ciclo cerrado. duracion_s: 8 - 'n': 3 on_screen: 1 · Responder, citando la fuente narracion: >- El primero es responder. Cuánto dura una sesión de pago, con qué campo concilias contra tu extracto, qué valores admite un campo concreto. Consulta esta misma documentación y responde citando el documento del que sale la respuesta. No registra cuentas ni monta nada: una pregunta se contesta y termina ahí. visual: Una pregunta concreta y su respuesta, con la cita del documento del que sale. duracion_s: 19 - 'n': 4 on_screen: Si no está, lo dice narracion: >- Y si la documentación no lo dice, lo dice. No lo supone. Esa es la mitad del valor: preguntas como qué porcentaje exacto de comisión del banco te aplican, o cómo se hace un reembolso, tienen hoy una única respuesta honesta, y es que eso no está documentado. Un agente que se las inventa con aplomo es peor que no tener agente. visual: Una respuesta que se detiene, con un hueco explícito donde iría el dato, en vez de rellenarlo. duracion_s: 24 - 'n': 5 on_screen: 'El segundo trabajo: integrar' visual: Lámina de sección, sin voz. duracion_s: 3 - 'n': 6 on_screen: Cerrar el ciclo narracion: >- El segundo trabajo es integrar, y ese sí tiene procedimiento. Escribe la aplicación y cierra el ciclo: crea el acuerdo y la sesión, fuerza las dos fases del pago, lanza un reto de firma corrompida contra tu propio servidor, y comprueba con el simulador —no contigo— que las tres cosas pasaron. Mientras no cierre el ciclo, la integración no está terminada: está escrita. visual: >- Un ciclo cerrado de cuatro pasos: acuerdo, sesión, las dos fases forzadas, y un reto de firma que vuelve al servidor propio. duracion_s: 24 - 'n': 7 on_screen: Los cuatro fallos que tiene dentro narracion: >- Y lo que lleva dentro son los cuatro fallos concretos de un agente integrando pagos. Que pagado no es dinero recibido, y nada se da por bueno en la primera fase. Que un aviso apuntado al propio simulador se auto-contesta y da verde falso. Que una respuesta correcta no prueba que verificas la firma: eso solo lo prueba un rechazo. Y que si no puede alcanzar la documentación, se para y te lo dice en vez de improvisar de memoria. visual: 'Cuatro tarjetas de criterio en fila: dos fases, autocontestarse, firma, y pararse.' duracion_s: 31 - 'n': 8 on_screen: Por qué no sabe la API de memoria visual: Lámina de sección, sin voz. duracion_s: 3 - 'n': 9 on_screen: Criterio dentro · conocimiento fuera narracion: >- Debajo de los dos trabajos hay una decisión de diseño que lo sostiene todo: no sabe la API de memoria, a propósito. No lleva copia del catálogo de endpoints. Lleva criterio, que es qué tiene que cumplir lo que escribe, y procedimiento, que es cómo se comprueba. El conocimiento lo consulta por HTTP en cada sesión, contra este portal. visual: >- Un paquete pequeño y ligero conectado por una línea viva a una biblioteca grande, en vez de contenerla dentro. duracion_s: 23 - 'n': 10 on_screen: No se desactualiza, y es reproducible narracion: >- De ahí salen dos cosas que importan. Que el día que cambiemos una página, lee la versión nueva sin que nadie reinstale nada: no hay una copia envejeciendo dentro del paquete. Y que cada respuesta viene con la versión del corpus que usó, para poder reproducirla: si algo salió mal, se reconstruye después contra la documentación exacta que lo produjo. visual: >- Una página que cambia y el agente leyendo ya la versión nueva, sin ninguna reinstalación de por medio. duracion_s: 23 - 'n': 11 on_screen: Y lo que te ahorra al integrar narracion: >- En el día a día eso se nota en cosas pequeñas: distingue tus dos tokens y sabe que entrar en la consola invalida el que tenías guardado; guarda tus credenciales por entorno, nunca escritas en el código, y las añade a tu gitignore; y reutiliza las que ya tengas antes de registrar una cuenta nueva, porque registrar por costumbre te parte la traza en dos y te hace depurar en el sitio equivocado. visual: Un fichero de credenciales fuera del código, con el .gitignore actualizado al lado. duracion_s: 28 - 'n': 12 on_screen: Y lo que no hace narracion: >- Y para saber cuándo no molestarla: no sustituye a la documentación, no sale a producción por ti, no decide tus reglas de negocio, y no inventa lo que no está. Se activa sola en cuanto mencionas SPIDI o su simulador; no hace falta invocarla por su nombre. Sigue con cómo se instala. visual: Cierre de marca; una lista corta de límites claramente delimitada. duracion_s: 20