Powers hacia funciones serverless

A veces la acción que necesita tu agente no existe todavía en ningún sistema de terceros: es lógica propia, específica de tu producto. Para ese caso, el marketplace de Arko no te limita a integraciones prearmadas —puedes apuntar un Power a una función serverless propia en Vercel, Cloudflare o Supabase y tratarla como cualquier otra herramienta.

Por qué serverless y no un servidor propio

Una función serverless resuelve exactamente el perfil de tráfico de un Power: se invoca de forma esporádica, cuando el agente decide llamarla, no de forma constante. No necesitas mantener un proceso corriendo veinticuatro horas para atender una acción que quizás se dispare diez veces al día; la función se despierta, responde y se apaga.

Configura el Power

La url es el endpoint público de tu función —una ruta de Vercel, un Worker de Cloudflare o una Edge Function de Supabase—; el método lo defines tú según lo que haga la función, típicamente POST cuando muta algo y GET cuando solo consulta. La cabecera de autenticación protege la función de invocaciones que no vengan de Arko.

• Un secreto compartido en la cabecera, verificado en la primera línea de tu función.
• Validación estricta de cada parámetro que llega, igual que harías con cualquier endpoint público.
• Una respuesta JSON breve y predecible, para que el agente la interprete sin ambigüedad.

La ventaja de controlar los dos extremos

Cuando el Power apunta a código tuyo, no dependes de que un tercero documente bien su API ni de sus límites de uso: defines tú la forma exacta de la respuesta, el manejo de errores y hasta cuánta lógica de negocio vive ahí antes de responder. Es la opción con más trabajo inicial, pero también la de mayor control.