Recetas
Soluciones cortas y probadas a problemas concretos al construir con modelos, con pasos numerados, código y cómo comprobar que funcionan.
RecetasUna receta resuelve un problema concreto en menos de una hora. Sin teoría de fondo: lo justo para que funcione y para que sepas comprobarlo. Si necesitas entender el porqué, cada receta enlaza a la lección o al artículo de docs que lo explica.
Formato de cada receta
Todas siguen la misma estructura, para que encuentres lo que buscas sin leer de arriba abajo:
- Problema: qué quieres conseguir, en dos frases.
- Ingredientes: lo que necesitas antes de empezar.
- Pasos: lista numerada con el código de cada paso.
- Cómo comprobar que funciona: una prueba que puedes ejecutar.
- Variaciones: adaptaciones habituales.
- Errores típicos: lo que suele fallar y cómo evitarlo.
La cabecera indica el tema, el nivel y los minutos estimados.
Por tema
Prompting: Clasificar y enrutar tickets de soporte · Resumen de reuniones con acciones y responsables
Herramientas: Extraer datos de facturas a JSON validado · Servidor MCP de solo lectura
RAG: Trocear documentos con solapamiento · Búsqueda híbrida con BM25 y embeddings
Agentes: Aprobación humana antes de actuar
Evals: Evals de regresión en CI · Modelo juez con rúbrica
Producción: Recortar costes con prompt caching · Reintentos y límites de tasa · Streaming de respuestas
Por dónde empezar
Si tienes algo en producción, las tres recetas de producción te ahorran dinero y errores desde el primer día. Si estás montando tu primer RAG, empieza por trocear documentos.
Todas las recetas
12 de 12 recetas
Nada con estos filtros.
-
Aprobación humana antes de actuar
Intercepta las llamadas a herramientas peligrosas de tu agente, pide confirmación a una persona con los argumentos exactos y devuelve el rechazo al modelo como tool_result.
python · anthropic -
Búsqueda híbrida con BM25 y embeddings
Combina búsqueda por palabras clave con BM25 y búsqueda vectorial con embeddings, y fusiona los dos rankings con Reciprocal Rank Fusion en Python.
python · rank-bm25 · numpy -
Clasificar y enrutar tickets de soporte
Clasifica cada ticket en una categoría y una prioridad cerradas con salida estructurada y mándalo a la cola del equipo que debe atenderlo.
python · anthropic -
Evals de regresión en CI
Ejecuta tus evals en cada pull request con GitHub Actions, publica el resumen en el job y bloquea el merge si el acierto baja del umbral.
python · anthropic · github-actions -
Extraer datos de facturas a JSON validado
Convierte el texto de una factura en un objeto JSON que cumple un esquema, con validación de importes en Pydantic y un camino claro para los casos dudosos.
python · anthropic · pydantic -
Modelo juez con rúbrica
Evalúa respuestas abiertas con un modelo juez que aplica una rúbrica de criterios binarios, devuelve un veredicto estructurado y se calibra contra etiquetas humanas.
python · anthropic · pydantic -
Recortar costes con prompt caching
Cachea la parte fija de tus peticiones (sistema, herramientas, documentos) con cache_control y comprueba con usage cuántos tokens se leen de caché.
python · anthropic -
Reintentos y límites de tasa
Qué reintenta ya el SDK por ti ante errores 429 y 529, cómo ajustar max_retries y cómo añadir una capa de backoff y control de concurrencia para trabajos por lotes.
python · anthropic -
Resumen de reuniones con acciones y responsables
Convierte la transcripción de una reunión en un JSON con resumen, decisiones y acciones con responsable, fecha y la cita que las respalda, y comprueba cada acción en código.
python · anthropic · pydantic -
Servidor MCP de solo lectura
Expón una base de datos SQLite a un agente mediante un servidor MCP en Python con MCPServer que solo puede leer, con límites de filas y de tiempo.
python · mcp · sqlite -
Streaming de respuestas
Muestra la respuesta del modelo a medida que se genera, en consola y en un endpoint web con Server-Sent Events, sin perder el mensaje final ni el stop_reason.
python · anthropic · fastapi -
Trocear documentos con solapamiento
Divide documentos largos en trozos de tamaño controlado que respetan frases y párrafos, con solapamiento entre trozos y posiciones para citar la fuente.
python