Saltearse al contenido
Nappai Documentation

Google Sheet Writer

⚠️ ADVERTENCIA DE DEPRECACIÓN

Este componente está deprecado y será eliminado en una versión futura de Nappai. Por favor, migra a los componentes alternativos recomendados.

El Google Sheet Writer permite a los usuarios de Nappai enviar datos estructurados a una hoja de cálculo de Google. Puedes elegir una hoja existente o crear una nueva, y decidir si los datos se añaden al final o reemplazan el contenido actual.

¿Cómo funciona?

Cuando activas el componente, Nappai solicita un token de acceso a la API de Google Sheets. Con ese token, el componente llama a la API de Google Sheets para:

  1. Seleccionar o crear la hoja: Si has elegido un archivo existente, se abre; si no, se crea una nueva hoja con el título que indiques.
  2. Escribir los datos: Los datos que llegan al campo Input Data se convierten en filas y columnas y se envían a la hoja seleccionada.
  3. Modo de escritura:
    • append: Añade las nuevas filas al final de la hoja.
    • overwrite: Borra el contenido actual y escribe los nuevos datos desde la primera fila.

El proceso es completamente automático y no requiere intervención manual una vez configurado el componente.

Entradas

Campos de Entrada

  • Input Data: Data to be written.
    Recibe datos estructurados (por ejemplo, una lista de diccionarios) que se convertirán en filas de la hoja.

  • Select Google Sheet (optional): Select an existing Google Sheet to update, or leave blank to create a new one.
    Permite elegir un archivo de Google Sheets existente. Si lo dejas vacío, el componente creará un nuevo archivo.

  • New Sheet Title (if creating): Title for the new sheet (only used when creating a new sheet).
    Especifica el nombre que tendrá la hoja recién creada.

  • Sheet Name: Name of the sheet to write to (optional).
    Si el archivo contiene varias pestañas, puedes indicar cuál usar. Si lo dejas vacío, se usará la primera pestaña.

  • Write Mode: Choose whether to append data or overwrite the sheet.
    Define si los datos se añaden al final o reemplazan el contenido existente.

  • Tool Name: The name of the tool that will be used when this component is connected as a tool.
    Este nombre aparecerá ante el agente cuando seleccione herramientas.

  • Tool Description: A detailed description of what this tool does.
    Proporciona contexto al agente sobre la función de la herramienta.

  • Tools arguments metadata: Defines the arguments metadata for the tools.
    Contiene la información necesaria para que el agente invoque la herramienta correctamente.

Credencial requerida
Este componente necesita una credencial de tipo Google Sheets API.

  1. Ve a la sección de credenciales de Nappai y crea una nueva credencial de Google Sheets API.
  2. En el componente, selecciona esa credencial en el campo Credential.
    La credencial debe incluir:
  • Client Id (clave de cliente de Google Cloud)
  • Client Secret (secreto de cliente de Google Cloud)
  • Spreadsheet read access (opción de acceso de lectura/escritura).

Salidas

  • Result: Tipo de datos Data (método: write_content).
    Contiene los datos que se enviaron a la hoja, útil para verificar que la operación se realizó correctamente.

  • Tool: Tipo de datos Tool (método: to_toolkit).
    Permite que el componente actúe como una herramienta que puede ser llamada por agentes de IA.

Ejemplo de Uso

  1. Conectar un flujo de datos:

    • Conecta la salida de un componente que genere datos (por ejemplo, un Data Extractor) al campo Input Data del Google Sheet Writer.

  2. Configurar la hoja:

    • Si ya tienes un archivo, selecciona su ID en Select Google Sheet (optional).
    • Si quieres crear uno nuevo, deja ese campo vacío y escribe un título en New Sheet Title (if creating).

  3. Elegir el modo:

    • Selecciona append para añadir filas nuevas sin borrar las existentes.
    • Selecciona overwrite si quieres reemplazar todo el contenido.

  4. Ejecutar:

    • Haz clic en Run y verifica la salida Result para confirmar que los datos se escribieron correctamente.

Componentes Relacionados

  • Google Sheet Reader – Lee datos de una hoja de cálculo de Google.
  • Google Sheet Writer (Legacy) – Versión anterior del componente, que ya está deprecada.

Consejos y Mejores Prácticas

  • Verifica los permisos: Asegúrate de que la credencial tenga acceso de escritura a la hoja de cálculo.
  • Usa append para logs: Si estás registrando eventos, append evita sobrescribir datos importantes.
  • Controla el tamaño de los datos: Google Sheets tiene límites de 5 000 000 de celdas por archivo; evita enviar volúmenes excesivos de una sola vez.
  • Prueba con datos de muestra: Antes de usar datos reales, prueba con un conjunto pequeño para confirmar que la estructura se escribe correctamente.

Consideraciones de Seguridad

  • Protege la credencial: La credencial de Google Sheets API contiene información sensible; no la compartas públicamente.
  • Revisa los scopes: La credencial debe incluir el scope https://www.googleapis.com/auth/spreadsheets para lectura y escritura.
  • Audita los logs: Nappai registra las llamadas a la API; revisa los logs para detectar accesos inesperados.