# Ejemplos de peticiones

> Peticiones reales que puedes hacer a tu agente, agrupadas por tema, con lo que hace Dilohost en cada una y lo que te contesta el agente.

Con Dilohost no hay comandos que memorizar: pides las cosas como se las pedirías a una persona. Estos ejemplos sirven de punto de partida. Debajo de cada uno verás qué herramienta usa el agente y qué te devuelve.

> [!NOTE]
> Las respuestas son orientativas: cada agente lo cuenta con sus palabras. Las direcciones del tipo `a1b2c3d` son el identificador de tu cuenta, que cambia en cada caso.

## Tu cuenta

### Ver qué tienes

<p class="prompt">¿Qué tengo en Dilohost y cuánto llevo gastado este mes?</p>

El agente consulta tu cuenta (`account.info` y `account.usage`) y te resume tu plan, los proyectos, webs, bases de datos y dominios que tienes, lo que llevas usado de cada límite y el crédito de uso que te queda este mes.

### Elegir plan

<p class="prompt">Necesito una base de datos para mi tienda. ¿Qué plan me hace falta y cuánto cuesta?</p>

El agente lee el catálogo de planes (`account.plans`) y te dice cuál incluye bases de datos y su precio, sin inventárselo. Si decides contratarlo, te prepara un enlace de pago seguro de Stripe (`billing.checkout`); el pago lo haces tú en esa página.

## Publicar

### Una web desde cero

<p class="prompt">Hazme una web de una página para mi peluquería «Corte Fino», con horario, dirección y un botón de WhatsApp, y publícala.</p>

El agente escribe la web, crea un proyecto (`project.create`) y la publica (`deploy.publish`). Al ser HTML y CSS, queda en línea en segundos:

```text
Ya está publicada en https://web-cortefino-a1b2c3d.dilosite.es
```

### Un proyecto que ya tienes

<p class="prompt">Publica esta app de Laravel en Dilohost, en un proyecto llamado tienda.</p>

Desde Claude Code u otro agente con terminal, el agente pide un remoto git de Dilohost (`deploy.git_remote`) y hace `git push`. Dilohost detecta que es Laravel, la construye y la pone en línea. El agente consulta el estado (`deploy.status`) hasta que diga «en línea» y te da la dirección. Desde claude.ai, en lugar del push te da un enlace para que subas el proyecto en un zip (`upload` con `mode="page"`).

### Una dirección más bonita

<p class="prompt">Cambia la dirección de la web de la peluquería a cortefino.dilosite.es.</p>

El agente comprueba que el nombre está libre y te pide confirmación, porque la dirección anterior dejará de funcionar (`deploy.subdomain`). Cuando dices que sí, la web pasa a `https://cortefino.dilosite.es` al momento.

### Volver atrás

<p class="prompt">La última versión de la tienda ha roto el carrito. Vuelve a la de ayer.</p>

El agente mira el historial (`deploy.history`), localiza la versión anterior y vuelve a ella sin reconstruir nada (`deploy.rollback`). Te dice qué número de versión está ahora en línea.

## Bases de datos y ficheros

### Base de datos conectada

<p class="prompt">Crea una base de datos PostgreSQL para la app web del proyecto tienda y conéctasela.</p>

El agente crea la base con su propio usuario (`database.create`) y guarda la conexión como variables secretas de la app (`database.connection` con `inject_into`). La contraseña no aparece en la conversación. Te avisa de que la app se reinicia para leer las variables nuevas.

### Copia antes de un cambio delicado

<p class="prompt">Haz una copia de la base de datos de la tienda ahora, antes de que lance la migración.</p>

El agente lanza una copia inmediata (`backup.now`) y, cuando termina, te lo confirma. Si luego hiciera falta, puede restaurarla (`backup.restore`), siempre después de que lo confirmes, porque sustituye los datos actuales.

### Migraciones

<p class="prompt">Ejecuta las migraciones de Laravel en la tienda.</p>

El agente ejecuta `php artisan migrate --force` dentro de la app (`app.run`) y te enseña la salida. Solo se admiten comandos de mantenimiento de una lista cerrada, no una consola libre.

## Dominios

### Comprar un dominio

<p class="prompt">¿Está libre cortefino.es? Si lo está, cómpralo y ponlo en la web de la peluquería.</p>

El agente busca el dominio y su precio (`domain.search`). Para comprarlo necesita los datos del titular, que eres tú o tu empresa (`domain.contact_create`), y tu confirmación con el precio final (`domain.buy`); se paga con el saldo de tu cuenta. Después lo une a la web (`domain.attach`) y el certificado HTTPS se pone solo.

### Traer el dominio que ya tienes

<p class="prompt">Quiero usar mi dominio panaderiaana.com, que tengo en otro proveedor, para mi web.</p>

El agente inicia la conexión (`domain.connect`) y te da un registro TXT para que demuestres que el dominio es tuyo. Cuando lo añades en tu proveedor, lo verifica (`domain.verify`) y te explica el siguiente paso: cambiar los servidores DNS o apuntar solo la web.

## Correo

### Un buzón con tu dominio

<p class="prompt">Crea el correo info@cortefino.es para la peluquería.</p>

Si el correo aún no está activado en el dominio, el agente lo activa primero (`email.enable`). Después crea el buzón (`email.create`) tras enseñarte lo que cuesta y esperar tu confirmación. La contraseña la puedes dar en la conversación o ponerla tú en el panel; el agente te da los datos para configurar el móvil (`email.settings`).

### Traer el correo antiguo

<p class="prompt">Tengo el correo de la panadería en Gmail. Pásalo todo a Dilohost.</p>

El agente sigue la guía de migración (`email.guide`): comprueba de dónde viene el correo, prepara el buzón de destino y copia los mensajes (`email.migrate`), informándote del progreso (`email.migrate_status`) hasta que termina.

## Cuando algo falla

### Diagnóstico

<p class="prompt">La web de la tienda da error 502. ¿Qué le pasa?</p>

El agente pide un diagnóstico (`app.diagnose`) y lee los registros recientes (`app.logs`). Te explica en lenguaje llano qué falla (por ejemplo, que la app no escucha en el puerto que toca o que le falta una variable) y qué hay que cambiar.

### Visitas

<p class="prompt">¿Cuántas visitas ha tenido la web de la peluquería esta semana y de dónde vienen?</p>

El agente consulta las estadísticas de los últimos días (`app.traffic`): páginas vistas, visitantes, páginas más vistas, de dónde llegan y cuánto tardan en cargar. No necesitas instalar ninguna analítica.

## Si algo no existe

<p class="prompt">Quiero que la web me mande un SMS cada vez que alguien reserve.</p>

Si ninguna herramienta lo cubre, el agente te lo dice y, si quieres, deja la petición al equipo de Dilohost (`feature_request.create`), sin prometerte fechas.

## Relacionado

- [Conceptos básicos](/docs/conceptos)
- [Referencia de herramientas](/docs/referencia/herramientas)
- [Confirmaciones](/docs/seguridad/confirmaciones)