Redacta respuestas de correo electrónico con IA usando Hugging Face

Consigue tu clave digital (token de API)

Primero, obtengamos tu clave digital única, conocida como token de API. Una API (Interfaz de Programación de Aplicaciones) es como el menú digital y el sistema de pedidos de un restaurante, permitiendo que diferentes programas informáticos se comuniquen entre sí. Tu token de API es como tu pase VIP personal y secreto que le dice al "camarero" de Hugging Face (la API) que estás autorizado para hacer un pedido.

Abre tu navegador web y ve al sitio web de Hugging Face. Inicia sesión en tu cuenta. Una vez que hayas iniciado sesión, normalmente verás una página limpia, quizás con tu feed de actividad. Busca tu foto de perfil (generalmente un círculo con tu inicial o imagen elegida) en la esquina superior derecha de la pantalla. Haz clic en ella. Se desplegará un menú mostrando opciones como "Profile," "Settings," y "Sign Out." Selecciona "Settings" de este menú. En la siguiente pantalla, verás una barra lateral a la izquierda con varias configuraciones de cuenta. Haz clic en "Access Tokens". Luego verás un botón que dice "New token." Haz clic en él. Aparecerá una pequeña ventana pidiendo detalles. Dale a tu token un nombre descriptivo como "Email-Reply-Bot" y establece el Role en "read." Este rol de "read" significa que el token solo te permite recibir información (como texto generado por IA), no cambiar nada en tu cuenta. Haz clic en "Generate a token." Aparecerá en la pantalla una cadena de caracteres muy larga y aleatoria (tu token de API). ¡Copia inmediatamente este token! Puedes hacer clic en el icono de copiar que está al lado. Trata este token como una contraseña, no lo volverás a ver una vez que abandones esta página. Guárdalo en un lugar seguro temporalmente, como un documento de texto simple, ya que lo necesitarás pronto.

Si se ve diferente: Si tu foto de perfil no está en la esquina superior derecha, busca un icono de cuenta general (como una silueta de persona) o un botón de menú (a menudo tres líneas horizontales, a veces llamado "menú de hamburguesa"). Las opciones "Settings" o "Access Tokens" podrían estar bajo nombres ligeramente diferentes, pero generalmente se encontrarán dentro de tu área de gestión de cuenta.

Sabrás que funcionó cuando hayas copiado con éxito una larga cadena de caracteres que comience con hf_ (por ejemplo, hf_ABCDEF1234567890) y la hayas guardado de forma segura.

Encuentra un "Chef" de IA (Modelo) para tu correo electrónico

Ahora necesitas elegir un modelo de IA, lo cual es como seleccionar un chef específico para tu comida. Cada modelo es un programa informático único entrenado para diferentes tareas. Para redactar correos electrónicos, querrás un modelo de "generación de texto", uno diseñado específicamente para producir texto nuevo basándose en tus instrucciones.

Abre una nueva pestaña del navegador y navega al Hugging Face Hub. En esta página, verás una barra de búsqueda prominente, usualmente en el medio o cerca de la parte superior. En esta barra de búsqueda, escribe text-generation. Mientras escribes, puede que aparezca una lista de modelos, o quizás necesites presionar Enter para ver los resultados. Luego verás muchos modelos de IA diferentes. Para un principiante, un buen punto de partida es gpt2 porque es bien conocido y generalmente efectivo para varias tareas de texto. También podrías ver distilgpt2 (una versión más pequeña y rápida) o microsoft/DialoGPT-medium. Haz clic en el modelo que hayas elegido (por ejemplo, haz clic en la tarjeta del modelo gpt2). En la página específica del modelo, en la parte superior, verás su ID de Modelo. Para gpt2, el ID de Modelo es simplemente gpt2. Anota este ID de Modelo, lo necesitarás para el siguiente paso.

Si se ve diferente: Si text-generation no produce buenos resultados, intenta buscar filtros en el lado izquierdo de la página y selecciona "Text Generation" bajo "Tasks." Los modelos más populares suelen aparecer primero o están claramente etiquetados.

Sabrás que funcionó cuando hayas anotado con éxito el ID de Modelo (por ejemplo, gpt2) de tu modelo de IA de generación de texto elegido.

Prepara tu "Pedido" (Solicitud de API)

Ahora, elaborarás la instrucción específica que quieres enviar a la IA. Esta instrucción se llama prompt. Combinarás tu token de API, el ID del modelo y tu prompt en un comando usando una herramienta llamada curl (se pronuncia "curl"). curl es una forma común de enviar solicitudes desde la terminal de tu ordenador a servicios web como la API de Hugging Face.

Abre la terminal de tu ordenador. En Windows, puedes buscar "Command Prompt" o "PowerShell" en el menú Inicio. En Mac o Linux, busca "Terminal." Una vez abierta, verás una ventana con un cursor parpadeante, listo para tu entrada. Utilizaremos un comando curl, que es una línea de código específica que envía tu solicitud. Tu comando incluirá:

• -X POST: Esto le indica a Hugging Face que estás enviando datos (como hacer un pedido).
• -H "Authorization: Bearer YOUR_API_TOKEN": Esto incluye tu pase VIP (token de API) para confirmar que estás autorizado a realizar la solicitud.
• -H "Content-Type: application/json": Esto le indica a Hugging Face que estás enviando información en formato JSON (JavaScript Object Notation), que es una forma estructurada para que los programas informáticos intercambien datos.
• -d '{ "inputs": "TU PROMPT", "parameters": { "max_new_tokens": 50, "return_full_text": false } }': Estos son los datos reales que estás enviando. "inputs" contiene tu prompt (la instrucción para la IA). "parameters" son instrucciones adicionales, como "max_new_tokens": 50 (solicitando unas 50 nuevas piezas de texto, llamadas tokens – un token es aproximadamente cuatro caracteres) y "return_full_text": false (lo que asegura que la IA solo envíe su respuesta generada, no también tu prompt original).
• https://api-inference.huggingface.co/models/YOUR_MODEL_ID: Esta es la dirección web de la "cocina" de IA donde tu modelo elegido está esperando.

Debes reemplazar YOUR_API_TOKEN con tu token real del Paso 1 y YOUR_MODEL_ID con el ID del modelo del Paso 2.

Si se ve diferente: Asegúrate de que tu terminal esté lista para aceptar comandos. Algunas redes corporativas podrían bloquear los comandos curl. Si encuentras errores como "command not found", es posible que debas contactar a tu departamento de TI o probar con otro ordenador.

Sabrás que funcionó cuando tengas una cadena de comando curl completa (como el ejemplo a continuación) que incluya tu token de API real y el ID de modelo elegido, lista para copiar y pegar en tu terminal.

curl -X POST \
  -H "Authorization: Bearer hf_YOURUNIQUEKEY123" \
  -H "Content-Type: application/json" \
  -d '{ "inputs": "El cliente no está satisfecho con el servicio y desea un reembolso. Redacta una respuesta educada y empática.", "parameters": { "max_new_tokens": 80, "return_full_text": false } }' \
  https://api-inference.huggingface.co/models/gpt2

Envía tu pedido a la "cocina" de IA

Con tu comando curl completo listo, es hora de enviarlo. Copia cuidadosamente todo el comando, incluyendo curl al principio y la URL del modelo al final. Luego, vuelve a la ventana de tu terminal abierta.

Pega todo el comando curl en la ventana de la terminal en el cursor parpadeante. Después de pegar, presiona la tecla Enter de tu teclado. Lo que sucede a continuación es que tu ordenador envía esta solicitud a través de internet a Hugging Face. La IA procesará tu solicitud, este proceso se llama inferencia. Puede tardar unos segundos, especialmente la primera vez que usas un modelo específico o si Hugging Face necesita "cargar" el modelo en sus servidores para ti. La ventana de la terminal normalmente permanecerá en blanco por un breve momento mientras espera una respuesta.

Si se ve diferente: Si no sucede nada durante mucho tiempo (más de 20-30 segundos), o ves un error inmediato como "Connection refused", verifica tu conexión a internet y asegúrate de que tu comando curl esté exactamente como se escribió, sin comillas ni caracteres faltantes. Una respuesta lenta podría significar simplemente que el modelo está tardando un momento en cargarse.

Sabrás que funcionó cuando, después de una breve espera, la ventana de la terminal muestre texto nuevo. Este texto típicamente comenzará con un corchete [ o una llave de apertura {, indicando que se han recibido datos.

Lee la "Respuesta" de la IA (Borrador de Correo Electrónico)

Después de una breve espera, verás algo de texto aparecer en tu terminal. Esto estará en formato JSON (JavaScript Object Notation), que es una forma estándar y organizada para que los programas se envíen datos entre sí. Puede parecer un poco complejo al principio, pero no te preocupes, estás buscando una parte específica.

La salida JSON típicamente mostrará una lista (indicada por []) que contiene uno o más objetos (indicados por {}). Dentro de uno de estos objetos, encontrarás la clave "generated_text". El texto que sigue inmediatamente a esta clave, encerrado entre comillas dobles, es tu respuesta de correo electrónico redactada por la IA. Por ejemplo, podrías ver algo como \"generated_text\": \"Estimado [Nombre del Cliente],\\n\\nGracias por contactarnos...\" (el \n significa una nueva línea, y \\ significa un solo carácter \). Lee este texto generado. Puedes resaltar y copiar el texto dentro de las comillas después de "generated_text".

Si se ve diferente: Si ves mensajes de error en lugar de JSON, regresa y revisa cuidadosamente el Paso 3 en busca de errores tipográficos en tu token de API, ID de modelo o la estructura de los datos JSON (especialmente las comillas). A veces, un max_new_tokens muy corto podría resultar en una respuesta muy breve o incompleta.

Sabrás que funcionó cuando puedas identificar y copiar claramente el texto del correo electrónico generado por IA dentro de la sección \"generated_text\": de la salida de la terminal. Luego puedes pegar este texto en tu programa de correo electrónico, personalizarlo con nombres, detalles específicos y la voz de tu marca, ya que la IA solo proporciona un borrador general.