Build with AI
YoRobot está pensado para que lo opere tu agente de código, no sólo vos. Estas son las tres piezas que hay que darle.
1. Conectar el MCP
Es la misma conexión del Quickstart. Con ella, el agente tiene 218 herramientas: crear y versionar agentes, cargar casos y ensayarlos, conectar apps, definir Datos, armar consolas, leer trazas y consumo. Lo único que no puede hacer es aprobar: aprobar le devuelve un enlace de un solo uso, y la aprobación la da la persona en el portal, con su sesión.
No las carga todas al conectarse: la lista trae un núcleo de 14 (las de casi toda sesión) más buscar_herramientas, usar_herramienta_lectura (para las que leen) y usar_herramienta (para las que escriben). El resto lo encuentra por intención («conectar WhatsApp») o por área y lo ejecuta por el mismo camino que la llamada directa. Cualquier herramienta se sigue pudiendo llamar por su nombre aunque no esté en la lista. El detalle, en la Referencia MCP.
2. Darle la documentación
Cada página de /docs existe también en Markdown en la misma URL con .md, y /llms.txt las enumera. Para que tu agente las lea:
> leé https://yorobot.ai/llms.txt y después https://yorobot.ai/docs/mcp.mdY /AGENTS.md es un archivo para pegar en tu repositorio: le dice a tu agente cómo autenticarse, qué contratos hay, y qué no intentar.
Para integrar tu proyecto de punta a punta —MCP, tu base, los agentes, el dashboard propio sobre la API y los webhooks— está la skill yorobot-integrar-proyecto: npx skills add PayDece/YoRobot --skill yorobot-integrar-proyecto (todas las skills).
3. Pedirle las cosas con el vocabulario del código
Los nombres de las herramientas son estables y en snake_case; los errores vuelven con un codigo que dice el próximo paso (no_existe → listar primero; sin_alcance → hace falta otro token; requiere_persona → esto lo decide alguien en la pantalla). Un buen pedido nombra la herramienta:
> con crear_agente armá un agente "Cobranzas" que lea las facturas vencidas de Odoo y
> proponga un mensaje por factura; que como_se_verifica cite la lectura de Odoo. Después
> cargá tres casos con cargar_caso y corré ensayar_agente.Desarrollo local: el puente
Mientras construís, tu proyecto corre en localhost y YoRobot corre en la nube: no llega a tu máquina. El puente local lo resuelve sin abrir ningún puerto hacia afuera.
yorobot login # tu sesión (OAuth), una vez
yorobot puente --puerto 3000 # --puerto se repite: --puerto 3000 --puerto 8080Y la herramienta se declara con la URL local://<puerto>/<ruta> —por crear_herramienta, o como sobreescritura de prueba de una herramienta que en producción apunta al sistema real—:
{"nombre":"reservas_del_dia","metodo":"GET","url":"local://3000/api/reservas","riesgo":"read","descripcion":"Las reservas de hoy."}Cómo funciona: la terminal se registra con tu sesión y le pregunta al portal (long-poll, siempre saliente) si hay llamadas para vos. Cuando un agente, en una tarea de prueba que pediste vos (probar_agente, yorobot agentes probar), usa esa herramienta, la llamada pasa por el mismo puente que cualquier otra —permisos, riesgo, aprobación, registro del intento— y el último tramo, en vez de salir a internet, llega a tu terminal, que la ejecuta contra http://127.0.0.1:3000 y devuelve la respuesta. La terminal muestra cada llamada (método, ruta, estado). «Probar» una lectura desde el portal también va por tu puente.
Las reglas:
- Sólo prueba (`dev`). En preproducción y producción una herramienta
local://no viaja, y una sobreescrituralocal://sólo se guarda para prueba. - Sólo tu máquina, sólo tus tareas. La llamada llega al puente de la persona que pidió la tarea, en su organización. Una automatización o un canal no llegan a ninguna máquina.
- Sólo los puertos que declaraste, sólo
127.0.0.1, sin seguir redirecciones que salgan de ahí; 15 s y 512 KB por respuesta. Sin puente vivo, el agente lee «el puente local de Ana no está conectado: corréyorobot puente --puerto 3000». - Sin credenciales de la bóveda. Una llave de un sistema del cliente no sale del worker hacia una computadora personal: una herramienta
local://no llevasecreto. En local tu proyecto decide su auth —apagala en desarrollo o usá una cabecera fija de desarrollo—. - Lo levanta una persona (técnico, desarrollador o admin) con su sesión: un token de API de una integración no puede. Queda en la auditoría quién lo levantó, desde qué equipo y con qué puertos, y cada llamada; lo que contestó tu proyecto no se guarda.
Lo que conviene saber antes
- El ambiente por defecto es
dev. Nada llega a un sistema real hasta que alguien promueve aprod. claveencrear_agenteycrear_rutinahace que repetir la llamada actualice en vez de duplicar. Pensalo como infraestructura declarativa.- Todo lo que el agente crea queda en la bitácora firmado por la persona dueña del token.
- Si el token quedó en un log,
revocar_mi_tokenlo apaga desde el mismo MCP.