Inicio Rápido

Empieza a usar AstrApp en 10 minutos. Esta guía te lleva desde la autenticación hasta tu primer modelo.

Antes de empezar necesitas:

Una cuenta en AstrApp (regístrate en app.astrapp.lat)
Datos de entrenamiento (conversaciones, FAQs, manuales)
Conocimientos básicos de APIs REST

Obtener tu API Key

Primero, genera una API Key desde el dashboard de AstrApp.

Inicia sesión en app.astrapp.lat
Ve a Configuración → Integraciones → API Keys
Haz clic en Generar Nueva Key
Copia la key y guárdala en lugar seguro

Importante: No podrás ver la key después de cerrar la ventana. Guárdala en un archivo .env

bash

# Crear archivo .env
echo "CLOUDJARS_API_KEY=sk_live_xxxxxxxxxxxxx" > .env

# Agregar a .gitignore
echo ".env" >> .gitignore

Verificar la conexión

Prueba que tu API Key funciona correctamente.

bash

curl -X GET https://api.astrapp.lat/api/v1/projects \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json"

Deberás recibir:

json

{
  "data": [],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 0
  }
}

Crear un proyecto

Los proyectos agrupan tus datasets, entrenamientos y modelos.

bash

curl -X POST https://api.astrapp.lat/api/v1/projects \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mi Primer Bot",
    "description": "Bot de ventas de prueba",
    "type": "sales_bot"
  }'

Guarda el id de la respuesta:

json

{
  "id": "proj_1a2b3c4d5e6f7g8h",
  "name": "Mi Primer Bot",
  "status": "active",
  "created_at": "2024-12-23T10:30:00Z"
}

Preparar datos de entrenamiento

AstrApp usa el formato JSONL (una línea JSON por registro).

Crea un archivo training_data.jsonl:

jsonl

{"conversation": "¿Cual es el precio?", "response": "Desde $9.99/mes", "category": "pricing"}
{"conversation": "¿Tienen soporte?", "response": "Si, 24/7 via chat", "category": "support"}
{"conversation": "¿Puedo cancelar?", "response": "Si, sin cargos", "category": "billing"}
{"conversation": "¿Ofrecen descuentos?", "response": "Si, 20% anual", "category": "pricing"}
{"conversation": "¿Como empiezo?", "response": "Registrate gratis", "category": "onboarding"}

Recomendaciones:

Mínimo 100 ejemplos para resultados decentes
500+ ejemplos para resultados buenos
Incluye variaciones de la misma pregunta

Subir el dataset

Sube tu archivo de entrenamiento al proyecto.

bash

PROJ_ID="proj_1a2b3c4d5e6f7g8h"

curl -X POST https://api.astrapp.lat/api/v1/projects/$PROJ_ID/datasets \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxx" \
  -F "file=@training_data.jsonl" \
  -F "name=Datos Iniciales" \
  -F "description=Conversaciones de ventas Q1"

El dataset se valida automáticamente. Espera a que el status sea "validated".

Entrenar el modelo

Inicia el entrenamiento con tu dataset validado.

bash

PROJ_ID="proj_1a2b3c4d5e6f7g8h"
DATASET_ID="dataset_abc123def456"

curl -X POST https://api.astrapp.lat/api/v1/projects/$PROJ_ID/training \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mi Primer Modelo",
    "dataset_id": "'$DATASET_ID'",
    "base_model": "gpt-4",
    "parameters": {
      "learning_rate": 0.001,
      "epochs": 10,
      "batch_size": 32
    }
  }'

El entrenamiento puede tardar varios minutos. Puedes monitorear el progreso consultando el endpoint /training/:job_id.

Usar tu modelo

Una vez completado el entrenamiento, usa tu modelo para hacer predicciones.

bash

MODEL_ID="model_final123abc"

curl -X POST https://api.astrapp.lat/api/v1/chat/completions \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'$MODEL_ID'",
    "messages": [
      {
        "role": "system",
        "content": "Eres un asistente de ventas profesional"
      },
      {
        "role": "user",
        "content": "¿Cual es el precio del plan profesional?"
      }
    ],
    "temperature": 0.7
  }'

Respuesta:

json

{
  "id": "chatcompletion_abc123",
  "choices": [{
    "message": {
      "role": "assistant",
      "content": "El plan profesional cuesta $9.99/mes..."
    }
  }],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 35
  }
}

¡Felicidades!

Acabas de entrenar tu primer modelo de IA con AstrApp.

Siguientes pasos

Aprende sobre autenticación

API Keys, OAuth y permisos

Explora la API completa

Todos los endpoints disponibles

Evalúa con Opik

Mide la calidad de tu modelo

Conecta integraciones

Webhooks, n8n, HubSpot