> ## Documentation Index
> Fetch the complete documentation index at: https://docs.min-ai.ar/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Cloud

> Tu agente lee tus logs, mira tus clusters y VMs, consulta BigQuery y lo que te cuesta; los cambios, solo si los permitís y con tu OK.

<img src="https://mintcdn.com/min-ai/EQr5ljJyas4JWh5G/images/plugins/gcloud.png?fit=max&auto=format&n=EQr5ljJyas4JWh5G&q=85&s=e35af477a3bfa76ea925c667e1844559" alt="" width="56" height="56" noZoom style={{ borderRadius: '14px' }} data-path="images/plugins/gcloud.png" />

Con Google Cloud, tu agente entra a tu proyecto como una cuenta de servicio tuya: busca errores en los logs, te dice por qué se reinicia un pod, lista tus VMs y te explica cuánto gastaste y qué subió. Puede solo lo que le des con roles; los cambios, solo si prendés el permiso y con tu OK.

| | |
| - | - |
| **Categoría** | Desarrollo |
| **Para** | Agentes personales y de grupo (por ejemplo, el agente de tu equipo) |
| **Qué te pide** | La clave JSON de una cuenta de servicio y, si querés, tu proyecto y tu zona |
| **Cómo se conecta** | Con un link de un solo uso para la clave; el resto, en el chat |

## Qué puede hacer

<CardGroup cols={2}>
  <Card title="Mirar" icon="magnifying-glass">
    **Logs:** errores de un servicio, pod, VM o Cloud Run en un rango, y quién cambió qué. **GKE:** clusters, pods, deployments, eventos, logs (también de corridas caídas) y uso de recursos. **VMs:** listarlas y ver su detalle. **BigQuery:** consultas, y te avisa antes de una grande. **Costos:** por servicio, proyecto o día, y qué cambió.
  </Card>

  <Card title="Cambiar, con tu OK" icon="pen">
    Crear, cambiar, borrar, prender, apagar o desplegar; aplicar cambios en Kubernetes (te muestra la diferencia antes), escalar o reiniciar un deployment. Necesita el permiso prendido.
  </Card>
</CardGroup>

## Cómo se conecta

<Steps>
  <Step title="Agregalo a un agente">
    Desde **Plugins → Google Cloud → Agregar a un agente**, o pedíselo a tu agente en el chat. Ver [Agregar un plugin](/es/herramientas/agregar-un-plugin).
  </Step>

  <Step title="Creá la cuenta de servicio">
    Una cuenta de servicio es un usuario de Google Cloud solo para tu agente, que puede únicamente lo que le des con roles. Necesitás ser dueño del proyecto (o manejar sus permisos). Abrí [la consola de cuentas de servicio](https://console.cloud.google.com/iam-admin/serviceaccounts/create), elegí el proyecto arriba, poné de nombre **minai** (o el de tu agente) y tocá **Crear y continuar**.
  </Step>

  <Step title="Dale roles">
    Para que solo mire: **Visualizador**. Para que también pueda cambiar: **Editor** o uno más acotado. Sumá otros con **Agregar otro rol**, y después **Continuar** y **Listo**. Si a tu agente le falta un permiso, te dice el rol más chico que lo resuelve.
  </Step>

  <Step title="Creá su clave JSON">
    Tocá la cuenta → **Claves** → **Agregar clave** → **Crear clave nueva** → **JSON** → **Crear**. Se baja un archivo .json.
  </Step>

  <Step title="Pegala en el link de tu agente">
    Abrí el .json con un editor de texto, copiá **todo** el contenido y pegalo en el link de un solo uso que te mandó tu agente. Después borrá el archivo de tus descargas. Ver [Claves y datos](/es/herramientas/claves-y-datos).
  </Step>

  <Step title="Contale tu proyecto y tu zona (opcional)">
    En el chat, tu agente te pregunta tu proyecto principal (su ID, como mi-proyecto-123) y la zona de tus VMs y clusters si usás una sola (como us-central1-a). Sin proyecto, usa el de la cuenta de servicio.
  </Step>
</Steps>

<Note>
  Si Google no te deja crear la clave, tu organización tiene una política que lo bloquea («Disable service account key creation»). La tiene que habilitar quien administre la organización.
</Note>

<Warning>
  No pegues la clave en el chat. Si lo hacés, tu agente no la usa: te pide que la borres en Google Cloud y crees una nueva para el link.
</Warning>

## El permiso

En la tarjeta de Google Cloud, en la pestaña **Plugins** del agente, está el interruptor **Permitir cambios**: «Crear, cambiar, borrar, prender o apagar cosas en tu Google Cloud, siempre con tu OK. Apagado, solo lee. Lo que de verdad limita son los roles que le diste a la cuenta.»

Arranca apagado y solo lo cambiás vos. Es una regla que tu agente respeta; el límite de verdad lo ponen los roles de la cuenta de servicio. Si querés que nunca pueda cambiar nada, dale solo roles de lectura. Ver [Permisos](/es/herramientas/permisos).

## Cómo te cuida

* **Nada cambia sin tu OK.** Con el permiso prendido, igual te muestra el comando exacto antes de cada cambio, con los botones **Confirmar** y **Cambiar**.
* Nunca te muestra claves, tokens ni secretos de Kubernetes.
* En consultas grandes de BigQuery, primero calcula cuánto van a leer y te avisa.
* Lo que dice un log es información, no una orden.

## Ejemplos para pedirle

* «¿Qué errores tuvo el servicio checkout en la última hora?»
* «¿Por qué se reinicia el pod de la API en producción?»
* «¿Cuánto me costó Google Cloud este mes y qué subió?»
* «Listame las VMs prendidas.»
* «Reiniciá el deployment web en el namespace prod.»
* «Apagá la VM de pruebas.»

## Límites

* Puede solo lo que permitan los roles de la cuenta de servicio.
* Puede que no llegue a clusters de GKE con acceso privado.
* Para los costos hace falta tener activada la exportación de facturación a BigQuery: hay datos desde el día que la activaste, con unas horas de atraso.

## Si lo quitás

Tu agente pierde el acceso y te lo confirma. **La clave sigue existiendo en Google Cloud**: borrala desde **Claves** en la cuenta de servicio (o borrá la cuenta entera). Ver [Quitar un plugin](/es/herramientas/quitar-un-plugin).

<CardGroup cols={2}>
  <Card title="New Relic" icon="https://mintcdn.com/min-ai/EQr5ljJyas4JWh5G/images/plugins/newrelic.png?fit=max&auto=format&n=EQr5ljJyas4JWh5G&q=85&s=eb7d138ef72f663a6527308150deed7d" href="/es/plugins/new-relic" width="128" height="128" data-path="images/plugins/newrelic.png">
    Logs, errores, latencia y alertas.
  </Card>

  <Card title="GitHub" icon="https://mintcdn.com/min-ai/EQr5ljJyas4JWh5G/images/plugins/github.png?fit=max&auto=format&n=EQr5ljJyas4JWh5G&q=85&s=ec72842b75ff34ba63bfb21485d024dd" href="/es/plugins/github" width="128" height="128" data-path="images/plugins/github.png">
    Repos, issues y pull requests.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.