Inicio rápido — Python

Integra Rayuela en tu aplicación Python y obtén tu primera recomendación en menos de 5 minutos.

Requisitos previos

Python 3.7 o superior
pip (gestor de paquetes de Python)
Una cuenta en Rayuela (regístrate en rayuela.ai)
Tu API Key (disponible en el dashboard después del registro)

Paso 1: Instalación

Instala las dependencias necesarias para interactuar con la API de Rayuela.

pip install requests

O si usas poetry:

poetry add requests

Paso 2: Configuración inicial

Crea un cliente Python para interactuar con la API de Rayuela.

import requests
import json

# Configuración
API_KEY = "sk_prod_tu_api_key_aqui"
BASE_URL = "https://rayuela-backend-e7apihrdoa-uc.a.run.app/api/v1"
headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json"
}

# Verificar conexión
response = requests.get(f"{BASE_URL}/health/auth", headers=headers)
if response.status_code == 200:
    print("OK: conexión exitosa")
else:
    print("Error: verifica tu API Key.")

Paso 3: Obtener recomendaciones

Solicita recomendaciones personalizadas para un usuario.

# Obtener recomendaciones para un usuario
payload = {
    "external_user_id": "user_123",
    "recommendation_goal": "user_engagement",
    "model_variant": "standard",
    "strategy": "hybrid",
    "limit": 5,
    "include_explanation": False,
    "filters": {
        "logic": "and",
        "filters": [
            {"field": "category", "op": "eq", "value": "electronics"},
            {"field": "price", "op": "lt", "value": 1000}
        ]
    }
}

response = requests.post(
    f"{BASE_URL}/recommendations/personalized/query",
    headers=headers,
    json=payload
)

if response.status_code == 200:
    recommendations = response.json()
    print("Recomendaciones:")
    for rec in recommendations["items"]:
        print(f"- Producto {rec['externalId']}: {rec['score']:.2f}")

Listo — siguientes pasos

Ya tienes configurado el cliente Python básico. Ahora puedes: