Saltearse al contenido

Conversation Files

Conversation Files es un componente sencillo que te permite obtener los archivos asociados a una conversación y preparar herramientas de medios que pueden usarse dentro de la misma. No realiza ninguna operación por sí mismo; simplemente recibe los parámetros necesarios y devuelve los datos y las herramientas listas para usar.

¿Cómo funciona?

El componente hereda de ConversationMediaToolsBase. Cuando lo añades al flujo, se ejecutan internamente dos métodos:

  1. fetch_conversation_files – Recupera los archivos que pertenecen a la conversación actual.
  2. build_conversation_media_tool – Crea objetos de herramienta que pueden ser llamados por el modelo de lenguaje para acceder a esos archivos.

No necesita conectarse a APIs externas; todo el procesamiento se hace dentro de Nappai. Solo debes proporcionar el modelo de incrustación, el modelo de lenguaje y las herramientas que quieres habilitar.

Entradas

Campos de Entrada

  • Embedding: Especifica el modelo de incrustación que se usará para procesar los archivos. Se pasa como entrada al modelo de lenguaje.
  • Model: Selecciona el modelo de lenguaje que se utilizará para generar respuestas o procesar los archivos.
  • Tools: Elige las herramientas que deseas usar dentro de la conversación. Puedes seleccionar varias opciones.

Salidas

  • Data: Conjunto de archivos de conversación recuperados. Puedes usarlo para mostrarlos en una tabla, descargarlos o procesarlos con otro componente.
  • Tools: Lista de herramientas construidas que pueden ser invocadas por el modelo de lenguaje para interactuar con los archivos (por ejemplo, leer, buscar o adjuntar archivos).

Ejemplo de Uso

  1. Añade el componente “Conversation Files” al flujo.
  2. Configura las entradas:
    • Embedding: text-embedding-ada-002
    • Model: gpt-4
    • Tools: FileSearch, FileRead
  3. Conecta la salida Data a un widget de tabla para mostrar la lista de archivos disponibles.
  4. Conecta la salida Tools al bloque de “LLM” para que el modelo pueda usar las herramientas de medios cuando responda a la conversación.

Con esta configuración, cada vez que el usuario haga una pregunta, el modelo podrá buscar y leer archivos de la conversación sin que tengas que escribir código adicional.

Componentes Relacionados

  • ConversationTools – Herramientas generales de conversación que pueden complementarse con las de medios.
  • ConversationMediaToolsBase – Clase base que define la lógica común para los componentes de medios de conversación.

Consejos y Mejores Prácticas

  • Selecciona solo las herramientas necesarias para evitar sobrecargar la conversación con opciones innecesarias.
  • Revisa los permisos de los archivos antes de exponerlos a los usuarios finales.
  • Usa un modelo de incrustación ligero si el rendimiento es crítico; los modelos más grandes pueden tardar más en procesar los archivos.

Consideraciones de Seguridad

  • Asegúrate de que los archivos recuperados no contengan datos sensibles que no deban ser accesibles a todos los usuarios.
  • Configura los permisos de acceso a los archivos en Nappai para que solo los usuarios autorizados puedan verlos o modificarlos.