Brain Studio - Jelou AI Docs

Conectar tu función en Brain Studio

Despliega tu función

jelou functions deploy
# ✓ Deployed to https://mi-funcion.fn.jelou.ai

Crea una API key en apps.jelou.ai — la necesitarás en el paso 4.

Verifica que MCP está activo

curl https://mi-funcion.fn.jelou.ai/__health \
  -H "Authorization: Bearer sk_..."

Respuesta esperada:

{
  "status": "ok",
  "mode": "define",
  "tool": {
    "name": "mi-funcion",
    "description": "Busca información de clientes"
  }
}

Si usas app(), verás múltiples tools en el array tools.

Si tu función tiene config: { mcp: false }, no se expondrá como herramienta MCP. Asegúrate de que MCP esté activo (es el default).

Abre Brain Studio

En el dashboard de Jelou, navega a tu agente IA:AI Agent → Tools → Servidores MCP externos

Configura el servidor MCP

Completa los campos:

Campo	Valor
URL	`https://mi-funcion.fn.jelou.ai/mcp`
Header name	`Authorization`
Header value	`Bearer sk_...`

Selecciona las herramientas

Brain Studio descubrirá automáticamente las herramientas expuestas por tu función. Selecciona las que quieras que el agente pueda usar.Si usas app() con múltiples tools, cada uno aparece como una herramienta independiente con su nombre y descripción.

Prueba el agente

Inicia una conversación con el agente y pide algo que requiera usar tu herramienta. Por ejemplo:

“¿Cuál es el saldo del cliente 593987654321?”

El agente detectará que necesita invocar tu función, pasará los parámetros correctos, y mostrará la respuesta al usuario.

Multi-tool en Brain Studio

Si tu función usa app(), Brain Studio ve cada tool individualmente:

export default app({
  tools: {
    consultarSaldo: define({
      description: "Consulta el saldo de un cliente por teléfono",
      input: z.object({ telefono: z.string().min(10) }),
      handler: async (input) => ({ saldo: 150.00 }),
    }),
    crearTicket: define({
      description: "Crea un ticket de soporte",
      input: z.object({ asunto: z.string(), detalle: z.string() }),
      handler: async (input) => ({ ticketId: "TKT-001" }),
    }),
  },
});

En Brain Studio aparecerán:

consultarSaldo — “Consulta el saldo de un cliente por teléfono”
crearTicket — “Crea un ticket de soporte”

Puedes habilitar o deshabilitar cada herramienta individualmente.

Las descripciones de define() y las anotaciones .describe() de Zod en los campos de input son lo que Brain Studio muestra al agente IA. Descripciones claras y específicas mejoran la precisión del agente al decidir cuándo y cómo usar tu herramienta.

Troubleshooting

No aparecen herramientas
401 Unauthorized
El agente no usa la herramienta

Verifica que:

La función está desplegada (jelou functions deploy)
MCP está activo (config.mcp no es false)
La URL termina en /mcp
El token es correcto

Prueba manualmente:

curl https://mi-funcion.fn.jelou.ai/mcp \
  -H "Authorization: Bearer sk_..."

La API key es inválida o falta en el header Authorization. El deploy no genera ninguna credencial automáticamente — crea una en apps.jelou.ai y configura el header MCP como Authorization: Bearer <key>.Si tu función es legacy y todavía usa un runtime token, puedes verificarlo con:

jelou functions tokens list mi-funcion

jelou functions tokens create está deprecado (responde 410 Gone) — ya no puedes generar un runtime token nuevo. Consulta la guía de autenticación.

Revisa la description de tu define(). Si es vaga (como “Maneja datos”), el agente no sabe cuándo usarla. Usa descripciones específicas como “Busca un cliente por número de teléfono y retorna su nombre, email y saldo”.

​Conectar tu función en Brain Studio

​Multi-tool en Brain Studio

​Troubleshooting

Conectar tu función en Brain Studio

Multi-tool en Brain Studio

Troubleshooting