Inicio rápido - Jelou AI Docs

Instala el CLI

npm install -g @jelou/cli

Verifica la instalación:

jelou --version

Autentícate

Necesitas un token de acceso personal (créalo en el dashboard de Jelou).

jelou login
# Paste your access token: ****
# ✓ Logged in

En CI puedes pasar el token directamente: jelou login --token jfn_pat_tu_token

Inicializa un proyecto

Crea un directorio y ejecuta jelou functions init:

mkdir consultar-cliente && cd consultar-cliente
jelou functions init
# ? Function slug: consultar-cliente
# ? Description: Busca información de clientes para el bot de WhatsApp
# ? Create new or link existing? Create new
# ✓ Created consultar-cliente

Esto te genera los archivos base:

Archivo	Propósito
`index.ts`	Tu función principal
`jelou.json`	Configuración del proyecto
`deno.json`	Import map del SDK
`.env`	Variables de entorno locales

Escribe tu función

Reemplaza el contenido de index.ts con una función que busca clientes por teléfono:

index.ts

import { define, z } from "@jelou/functions";

export default define({
  name: "consultar-cliente",
  description: "Busca información de un cliente por número de teléfono para el bot de soporte",
  input: z.object({
    telefono: z.string().min(10).describe("Número de teléfono del cliente"),
  }),
  output: z.object({
    nombre: z.string(),
    email: z.string(),
    plan: z.string(),
    saldo: z.number(),
  }),
  handler: async (input, ctx) => {
    ctx.log("Buscando cliente", {
      telefono: input.telefono,
      company: ctx.company.id,
    });

    const apiKey = ctx.env.get("CRM_API_KEY");
    const res = await fetch(
      `https://crm.example.com/api/clientes?tel=${input.telefono}`,
      { headers: { Authorization: `Bearer ${apiKey}` } },
    );
    const cliente = await res.json();

    return {
      nombre: cliente.nombre,
      email: cliente.email,
      plan: cliente.plan,
      saldo: cliente.saldo,
    };
  },
});

Ejecuta en local

Inicia el servidor de desarrollo:

jelou functions dev
# ▸ Listening on http://localhost:3000
# ▸ Watching for changes...

Tu servidor se recarga automáticamente cuando editas archivos.

Prueba con curl

En otra terminal, envía una petición:

curl -X POST http://localhost:3000 \
  -H "Content-Type: application/json" \
  -d '{"telefono": "593987654321"}'

Respuesta:

{
  "nombre": "María García",
  "email": "[email protected]",
  "plan": "Premium",
  "saldo": 150.00
}

También puedes probar el endpoint MCP en http://localhost:3000/mcp y el health check en http://localhost:3000/__health.

Configura secrets

Antes de desplegar, agrega las variables de entorno que necesita tu función:

jelou functions secrets set consultar-cliente CRM_API_KEY=YOUR_CRM_API_KEY
# ✓ Set 1 secret

Despliega a producción

jelou functions deploy
# ▸ Files: index.ts (1.2 KB), jelou.json (98 B), deno.json (65 B)
# ? Deploy consultar-cliente? (Y/n) y
# ✓ Deployed to https://consultar-cliente.fn.jelou.ai

Tu función queda protegida por defecto. Para llamarla necesitas una API key de plataforma — créala en apps.jelou.ai, en la sección de configuración de la app, y envíala como Authorization: Bearer sk_.... Consulta la guía de autenticación para más detalles.

Tu función ya está disponible en producción. Los agentes IA de Jelou pueden invocarla como herramienta MCP automáticamente.

Verifica en producción

curl -X POST https://consultar-cliente.fn.jelou.ai \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk_..." \
  -d '{"telefono": "593987654321"}'

Monitorea los logs en tiempo real:

jelou functions logs consultar-cliente

Siguientes pasos

Validación de entrada/salida — esquemas Zod, coerción de tipos y formato de errores
Funciones multi-tool — agrupa varias herramientas en un solo despliegue con app()

​Siguientes pasos

Siguientes pasos