Saltearse al contenido

Capítulo 3 Gestión Dinámica de Datos con Control de Permisos

Ahora, construiremos el cerebro del sistema: un Agente que recibe toda la información contextualizada y decide qué acción tomar en Airtable.

Componentes Necesarios

  • Prompt
  • Agent
  • Gemini
  • Airtable (x4 - uno para cada operación: Leer, Crear, Actualizar, Borrar)
  • Telegram Message

Construcción y Configuración

  1. Prompt

    • Propósito: Formatear y consolidar toda la información para el Agente.
    • Conexiones:
      • Conecta la salida de permiso de escritura a la entrada permiso.
      • Conecta la salida de nombre de usuario a la entrada usuario.
      • Conecta la salida message del Telegram Webhook original a la entrada mensaje.
    • Configuración (Template):
      Permiso de escritura: {permiso}
      nombre de usuario : {usuario}
      mensaje : {mensaje}
  2. Agent

    • Propósito: El cerebro que interpreta la solicitud y decide qué herramienta usar.
    • Conexiones:
      • Conecta la salida prompt del Prompt a la entrada input_value del Agent.
      • Conecta un Gemini a su entrada llm.
    • System Prompt:
      Eres un asistente especializado en interactuar con una base de datos de Airtable. Tu función es ayudar a los usuarios a realizar consultas y ejecutar acciones basadas en sus solicitudes en lenguaje natural.
      **Reglas de permisos:**
      En cada solicitud, se te indicará si el usuario tiene o no permiso de escritura.
      - Si `Permiso de escritura` es `true`, puedes usar las herramientas para crear, actualizar o eliminar registros.
      - Si `Permiso de escritura` es `false`, **SOLO** puedes usar la herramienta de leer registros. Rechaza cualquier otra solicitud de modificación.
  3. Las Herramientas de Airtable (Airtable x4)

    • Propósito: Crear un “kit de herramientas” para el Agente.
    • Configuración: Añade cuatro componentes Airtable, cada uno configurado para la tabla Productos pero con una Operation diferente: Read, Create, Update y Delete. Dales nombres descriptivos como “leer”, “crear”, etc.
    • Conexiones: Conecta la salida component_as_tool de CADA UNO de estos cuatro componentes a la entrada tools del Agent.
  4. Telegram Message

    • Propósito: Enviar la respuesta final del Agente de vuelta al usuario.
    • Conexión: Conecta la salida response del Agent a la entrada text del Telegram Message.
    • Configuración: Usa la credencial de tu bot.

Arquitectura del Agente con herramientas de Airtable en NappAI.

¡Y listo! Al ejecutar este flujo, tendrás un bot de Telegram que no solo entiende lenguaje natural, sino que también respeta un sistema de permisos definido en una base de datos externa.