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:
fetch_conversation_files
– Recupera los archivos que pertenecen a la conversación actual.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
- Añade el componente “Conversation Files” al flujo.
- Configura las entradas:
Embedding
:text-embedding-ada-002
Model
:gpt-4
Tools
:FileSearch
,FileRead
- Conecta la salida
Data
a un widget de tabla para mostrar la lista de archivos disponibles. - 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.