Cargando
Cargando

Al crear aplicaciones con Claude, comprender el ciclo de vida completo de las solicitudes te ayuda a tomar mejores decisiones arquitectónicas y a depurar problemas de forma más eficaz. Repasemos lo que sucede desde el momento en que un usuario hace clic en "enviar" en tu interfaz de chat hasta que la respuesta de Claude aparece en pantalla.

Ventana de chat con un mensaje de "You" que dice "What is quantum computing?", un cuadro de entrada en blanco y un botón Send.

El flujo de solicitudes de cinco pasos

Cada interacción con Claude sigue un patrón predecible con cinco fases distintas: solicitud al servidor, solicitud a la API de Anthropic, procesamiento del modelo, respuesta al servidor y respuesta al cliente.

Paso 1, Request to Server: una app web o móvil envía "What is quantum computing?" como una solicitud a tu servidor.

Por qué necesitas un servidor

Nunca debes hacer solicitudes a la API de Anthropic directamente desde código del lado del cliente. Aquí está el motivo:

  • Las solicitudes a la API requieren una clave de API secreta para la autenticación
  • Exponer esta clave en código del cliente crea una vulnerabilidad de seguridad grave
  • Cualquiera podría extraer la clave y hacer solicitudes no autorizadas

En su lugar, tu app web o móvil envía las solicitudes a tu propio servidor, el cual se comunica con la API de Anthropic utilizando la clave almacenada de forma segura.

Realizar solicitudes a la API

Cuando tu servidor contacta con la API de Anthropic, puedes usar un SDK oficial o hacer solicitudes HTTP simples. Anthropic ofrece SDKs para Python, TypeScript, JavaScript, Go y Ruby.

Paso Request to Anthropic API: el texto de entrada se coloca dentro de un mensaje "user", que luego se coloca en una lista de mensajes.

Toda solicitud debe incluir estos campos esenciales:

  • API Key - Identifica tu solicitud ante Anthropic
  • Model - Nombre del modelo a usar (como "claude-haiku-4-5")
  • Messages - Lista que contiene el texto de entrada del usuario
  • Max Tokens - Límite de cuántos tokens puede generar Claude

Dentro del procesamiento de Claude

Una vez que Anthropic recibe tu solicitud, Claude la procesa a través de cuatro etapas principales: tokenización, embedding, contextualización y generación.

Tokenization: la entrada del usuario "What is quantum computing?" dividida en los tokens "What", "is", "quantum", "computing" y "?".

Tokenización

Primero, Claude divide tu texto de entrada en fragmentos más pequeños llamados tokens. Estos pueden ser palabras completas, partes de palabras, espacios o símbolos. Para simplificar, piensa en cada palabra como un token.

Embedding

Cada token se convierte en un embedding: una larga lista de números que representa todos los significados posibles de esa palabra. Piensa en los embeddings como definiciones numéricas que capturan relaciones semánticas.

Diagrama que ramifica "quantum" hacia los cuatro significados que se listan debajo, además de su raíz latina "quantus", que significa cuánto.

A menudo las palabras tienen múltiples significados. Por ejemplo, "quantum" podría referirse a:

  • Una unidad discreta de magnitud física (física)
  • Conceptos de mecánica cuántica o física cuántica
  • Algo extremadamente pequeño o subatómico
  • Aplicaciones de computación cuántica

Contextualización

Claude refina cada embedding en función de las palabras circundantes para determinar el significado más probable en contexto. Este proceso ajusta las representaciones numéricas para resaltar la definición adecuada.

La etapa de Contextualization de la API de Anthropic unida a cinco columnas de decimales, como -0.34 y 0.87, enlazadas por arcos.

Generación

Los embeddings contextualizados pasan por una capa de salida que calcula probabilidades para cada posible palabra siguiente. Claude no siempre elige la palabra con mayor probabilidad; utiliza una combinación de probabilidad y aleatoriedad controlada para crear respuestas naturales y variadas.

Probabilidades de la siguiente palabra de la capa de salida: 30% "Quantum", 23% "Great", 19% "Are", 10% "What", 10% "This", 8% "To".

Después de seleccionar cada palabra, Claude la añade a la secuencia y repite todo el proceso para la siguiente palabra.

Cuándo deja de generar Claude

Después de cada token, Claude comprueba varias condiciones para decidir si continuar:

Los tokens de salida "Quantum mechanics is a form of computing." terminan en un token de fin de secuencia, con las tres comprobaciones de parada debajo.

  • Max tokens reached - ¿Se alcanzó el límite que especificaste?
  • Natural ending - ¿Generó un token de fin de secuencia?
  • Stop sequence - ¿Encontró una frase de parada predefinida?

La respuesta de la API

Cuando finaliza la generación, la API devuelve una respuesta estructurada que contiene:

  • Message - El texto generado
  • Usage - Recuento de tokens de entrada y salida
  • Stop Reason - Por qué terminó la generación

Respuesta que fluye desde la API de Anthropic de vuelta al SDK de Anthropic en tu servidor, con el texto de salida en un mensaje "assistant".

Tu servidor recibe esta respuesta y reenvía el texto generado de vuelta a tu aplicación cliente, donde aparece en la interfaz de usuario.

La pregunta de una app de chat "What is quantum computing?" va al SDK de Anthropic de tu servidor, luego a la API de Anthropic, y de vuelta.

Puntos clave

Comprender este flujo te ayuda a:

  • Diseñar arquitecturas seguras que protejan tus claves de API
  • Establecer límites de tokens adecuados para tu caso de uso
  • Gestionar los distintos motivos de parada en la lógica de tu aplicación
  • Depurar problemas comprendiendo dónde podrían ocurrir dentro del flujo

No te preocupes por memorizar cada detalle: el objetivo es familiarizarte con la terminología y el proceso general que encontrarás al trabajar con la API de Claude.