Getting started · for AI agents

Comienza con las habilidades del agente de agent4.io

Conecta tu agente de programación a agent4.io a través de MCP, instala las habilidades y ejecuta tu primera receta.

MCP tools:tenant_info

agent4.io ofrece un servidor MCP remoto (las herramientas) junto con un conjunto de habilidades (cómo usar las herramientas). Señala tu agente al punto de conexión MCP, instala las habilidades una vez y cada receta de abajo se convierte en un procedimiento ejecutable paso a paso.

Qué hace esta habilidad con tus datos — informa al usuario

Esta habilidad se conecta a la API remota de agent4.io (api.agent4.io). Sé explícito con el usuario antes de enviar su material:

Se transmite a agent4.io. La configuración del agente, el contenido de la base de conocimientos y las consultas que envías van a los servidores de agent4.io para construir y ejecutar agentes allí — ese es el propósito de la plataforma, no un efecto secundario.
Utiliza exactamente una credencial — tu clave de API de agent4.io (tk_…), que proporciona el usuario. No lee otras variables de entorno, y no lee ni enumera tus archivos locales: add_knowledge_file deliberadamente no puede acceder a las rutas de tu máquina; solo envías contenido que pasas explícitamente a una herramienta de base de conocimientos.
Nada se ejecuta con privilegios elevados. El instalador solo escribe archivos de habilidades en la carpeta de habilidades de tu agente — no sudo, y solo obtiene datos de agent4.io.
En un canal de chat, un token de bot que proporciona el usuario se utiliza únicamente para llamar a la API de ese propio canal por instrucción del usuario (por ejemplo, setMyCommands de Telegram) — nunca se envía a agent4.io.

Si alguno de estos puntos no es aceptable para el usuario, detente — no envíes sus datos.

Conectar — un comando

curl -fsSL https://api.agent4.io/v1/integration/install.sh | sh -s -- --key tk_YOUR_KEY

Esto añade el servidor MCP agent4-io e instala los módulos de habilidades para tu agente. Obtén una clave en consola → Configuración → Seguridad (el texto plano se muestra una vez, al crearla).

Verificar

tenant_info()   # → confirms you are connected to the right tenant

Mantenerlo actualizado

curl -fsSL https://api.agent4.io/v1/integration/install.sh | sh -s -- update

Vuelve a extraer las habilidades e informa qué módulos cambiaron. Las herramientas MCP son remotas, por lo que siempre están actualizadas; solo estos documentos de habilidades están versionados.

Comandos de barra diagonal (para tu CLI de codificación — no para el bot desplegado)

Estos son atajos de construcción para CLIs de codificación que leen una carpeta commands/ — Claude Code (~/.claude/commands/) y Cursor (.cursor/commands/). El instalador los coloca para que tú, construyendo en agent4.io, puedas escribirlos en tu CLI:

/agent4-agent <qué> — crear un agente fundamentado
/agent4-kb <nombre + fuente> — construir una base de conocimientos, importar, verificar, adjuntar
/agent4-skill <cuándo + qué> — autorar una habilidad de carga bajo demanda
/agent4-storyline <proceso> — compilar un proceso en una Storyline y publicar
/agent4-docs <pregunta> — buscar un concepto o cómo-hacer de agent4.io

Cada uno no tiene lógica propia — apunta a la habilidad agent4-io-* correspondiente y pasa lo que escribas.

No son los comandos del bot desplegado. No aparecerán — y no deberían — en el menú de barras diagonales de un bot de Telegram o WhatsApp. Esos menús se muestran a tus usuarios finales y se configuran por separado por el operador del bot (por ejemplo, setMyCommands de Telegram); enumeran acciones de usuarios finales, nunca operaciones de construcción como "crear un agente". Diferente audiencia, diferente mecanismo — si estás desplegando en un canal de chat, ignora estos y configura el menú de comandos propio de ese canal.

En OpenClaw / Codex (sin carpeta commands/) no hay archivos de comando separados: el agente utiliza la habilidad agent4-io directamente — el modelo la invoca, o llamas al único comando /agent4-io <tarea> — y los cinco atajos anteriores se condensan en eso.

¿Ejecutándose en un bot de Telegram / WhatsApp? Registra el menú tú mismo

Si tú (el agente) estás desplegado en un canal de chat, el menú de comandos del canal no se sincroniza desde las habilidades — lo configuras a través de la API propia del canal. Haz esto solo cuando este bot sea tu asistente de operador / construcción (la persona que lo usa construye en agent4.io); omítelo para un bot orientado a clientes, cuyo menú es para usuarios finales, no para operaciones de construcción.

Los nombres de comandos de Telegram solo pueden contener a-z 0-9 _ — sin guiones — así que renombra agent4-agent → agent4_agent. Cuando tengas el token del bot, regístralos una vez con setMyCommands:

curl -s "https://api.telegram.org/bot$BOT_TOKEN/setMyCommands" -H "Content-Type: application/json" -d '{
  "commands":[
    {"command":"agent4_agent","description":"Create a grounded agent"},
    {"command":"agent4_kb","description":"Build a knowledge base"},
    {"command":"agent4_skill","description":"Author a load-on-demand skill"},
    {"command":"agent4_storyline","description":"Compile a process into a Storyline"},
    {"command":"agent4_docs","description":"Look up an agent4.io doc"}
  ]}'

Cuando un usuario toca uno, el canal envía ese texto a ti como un mensaje ordinario — maneja esto con esta habilidad (agent4_agent = el atajo /agent4-agent, y así sucesivamente). ¿Sin token de bot / acceso a shell? Configura la misma lista manualmente en @BotFather → /setcommands. WhatsApp no tiene menú de barras diagonales; expone las mismas acciones como una lista interactiva/respuesta rápida en su lugar.

Silencia las vistas previas de tus propios enlaces. Citas enlaces de agent4.io constantemente, por lo que Telegram adjuntará una tarjeta de vista previa a casi cada respuesta — ruidoso rápido. Envía tus mensajes con vistas previas desactivadas: link_preview_options: {"is_disabled": true} en sendMessage (API heredada: disable_web_page_preview: true). Esto solo afecta a tus mensajes; un enlace que el usuario envía aún se previsualiza normalmente.

Cuando no hay una herramienta MCP para ello — la API REST es la superficie completa

Las herramientas MCP cubren las operaciones comunes de construcción y ejecución, pero no son toda la plataforma. Para cualquier cosa que no expongan — un campo, un punto de conexión, un trabajo por lotes — la API REST completa del inquilino cubre todo lo que un inquilino puede hacer. Llámalas directamente con la misma clave: X-API-Key: tk_....

Dos formas de acceder a ella, de menor a mayor costo:

search_agent4_docs("… rest api …") — la búsqueda de documentos ahora indexa la API REST por punto de conexión. Una consulta redactada en REST/HTTP devuelve el punto de conexión exacto con sus parámetros y respuesta, sin cargar toda la referencia. Usa esto primero.
https://agent4.io/api.md — la referencia completa legible por máquina (cada punto de conexión, parámetros, solicitud/respuesta, ejemplos). Lee todo el archivo solo cuando necesites la imagen general.

MCP es el camino rápido; la API REST es el respaldo.

Qué hacer a continuación

Cada receta nombra la herramienta MCP exacta y los argumentos — nunca "abre esta página y haz clic".