Saltar al contenido principal
La conexión de Google Cloud Platform permite a sus agentes autenticarse con servicios de GCP usando una clave JSON de cuenta de servicio. Una vez conectados, los agentes pueden acceder a BigQuery, Cloud Run y Cloud SQL según los roles IAM otorgados a la cuenta de servicio.

Agregar una Conexión GCP

  1. Vaya a Settings → Connections en el menú de navegación izquierdo.
  2. Bajo Cloud Platforms, haga clic en la tarjeta Google Cloud Platform.
  3. Haga clic en + Add GCP Connection.
  4. Complete el formulario y haga clic en Add Connection.

Formulario de Conexión

CampoRequeridoDescripción
Connection LabelUn nombre para mostrar para esta conexión (por ejemplo, Production GCP).
Service-account JSONPegue el contenido de su clave JSON de cuenta de servicio, o haga clic en Upload .json file para cargarla directamente.
GCP Project IDNoEl ID del proyecto GCP. Se predetermina al project_id en el JSON de la cuenta de servicio si se deja en blanco.
Default RegionNoLa región predeterminada para operaciones de Cloud Run y Cloud SQL (por ejemplo, us-central1).
BigQuery LocationNoLa ubicación del dataset/job de BigQuery (por ejemplo, US, EU).
Las credenciales se prueban contra Google IAM antes de guardarse, y la clave se almacena encriptada en la tabla de integraciones. Solo el client_email y el proyecto se exponen a los agentes.

Cómo Obtener una Clave JSON de Cuenta de Servicio

  1. Abra la Consola de Google Cloud → Cuentas de Servicio.
  2. Seleccione o cree una cuenta de servicio y otorgue los roles que necesite (por ejemplo, BigQuery Data Viewer, Cloud Run Invoker, Cloud SQL Client).
  3. Abra la pestaña KeysAdd keyCreate new key → seleccione JSON.
  4. Pegue el JSON descargado en el campo Service-account JSON, o cargue el archivo directamente.

Adminstrar Conexiones

Para ver, editar o eliminar conexiones GCP existentes, vaya a Settings → Connections y haga clic en la tarjeta Google Cloud Platform. Desde allí puede agregar conexiones adicionales o eliminar las que ya no sean necesarias.
Para usar una conexión GCP con un agente, vaya a los Toolkits del agente, agregue el toolkit de Google Cloud Platform y seleccione la conexión del menú desplegable Select GCP Connection. Para más detalles, consulte Google Cloud Platform Toolkit.