# 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](/docs/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](/docs/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:

```text
> leé https://yorobot.ai/llms.txt y después https://yorobot.ai/docs/mcp.md
```

Y `/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](https://github.com/PayDece/YoRobot/tree/main/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:

```text
> 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.

```bash
yorobot login                      # tu sesión (OAuth), una vez
yorobot puente --puerto 3000       # --puerto se repite: --puerto 3000 --puerto 8080
```

Y 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—:

```json
{"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 sobreescritura `local://` 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 lleva `secreto`. 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 a `prod`.
- `clave` en `crear_agente` y `crear_rutina` hace 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_token` lo apaga desde el mismo MCP.
