Saltar al contenido

Actividad Ollama Register Tools en Jitterbit Studio

Introducción

Una actividad Ollama Register Tools, que usa su conexión Ollama, registra herramientas con el modelo Ollama especificado y está diseñada para usarse como origen para proporcionar datos en una operación. Las definiciones de herramientas pueden provenir de la actividad List Tools del conector MCP Client o proporcionarse directamente a través de la transformación de solicitud como definiciones de herramientas personalizadas.

Cuando se ejecuta la operación, Jitterbit almacena las definiciones de herramientas registradas en memoria en el agente privado, asociadas con el ID de chat. Cualquier operación encadenada para ejecutarse después de esta que use el mismo ID de chat tiene acceso automático a esas herramientas cuando llama al modelo. No es necesario pasar las definiciones de herramientas explícitamente a la operación Prompt posterior. Si ya existe una herramienta con el mismo nombre registrada para el ID de chat, la nueva definición la reemplaza. Las herramientas almacenadas y el historial de conversación se limpian cuando se reinicia el agente.

Importante

Para usar la actividad Register Tools, se debe usar un agente privado.

Crear una actividad Ollama Register Tools

Se crea una instancia de una actividad Ollama Register Tools desde una conexión Ollama usando su tipo de actividad Register Tools.

Para crear una instancia de una actividad, arrastra el tipo de actividad al lienzo de diseño o copia el tipo de actividad y pégalo en el lienzo de diseño. Para obtener más detalles, consulta Crear una instancia de actividad en Reutilización de componentes.

Se puede editar una actividad Ollama Register Tools existente desde estas ubicaciones:

Configurar una actividad Ollama Register Tools

Sigue estos pasos para configurar una actividad Ollama Register Tools:

Paso 1: Ingresa un nombre y especifica configuraciones

En este paso, proporciona un nombre para la actividad, selecciona un modelo y especifica una solicitud y configuraciones opcionales. A continuación se describe cada elemento de la interfaz de usuario de este paso.

Consejo

Los campos con un icono de variable admiten el uso de variables globales, variables de proyecto y variables Jitterbit. Comienza escribiendo un corchete de apertura [ en el campo o haz clic en el icono de variable para mostrar un menú con las variables existentes entre las que elegir.

  • Menú Endpoint: Si tienes varios endpoints del mismo tipo de conector configurados, un menú en la parte superior de la pantalla muestra el nombre del endpoint actual. Haz clic en el menú para cambiar a un endpoint diferente. Para obtener más información, consulta Cambiar el endpoint asignado en Pantallas de configuración.

    • Editar endpoint: Aparece cuando pasas el cursor sobre el nombre del endpoint actual. Haz clic para editar la configuración de conexión del endpoint seleccionado actualmente.

  • Nombre: Ingresa un nombre para identificar la actividad. El nombre debe ser único para cada actividad de Registrar herramientas de Ollama y no debe contener barras diagonales / ni dos puntos :.

  • ID de chat: Ingresa un ID de chat para recuperar el contexto de una conversación anterior. Si se deja vacío y no se proporciona en la transformación de solicitud, se genera un nuevo ID de chat y se proporciona en la respuesta de la actividad.

  • Elegir opción: Especifica el método de selección de modelo, ya sea Listar todos los modelos o Ingresa identificador de modelo.

  • Listar todos los modelos: Selecciona esta opción para elegir de una lista de modelos recuperados del punto de conexión de Ollama:

    • Seleccionar un modelo: Esta sección muestra los modelos disponibles en el punto de conexión de Ollama. Solo se enumeran los modelos que admiten llamadas de herramientas. Los modelos DeepSeek se excluyen de la lista.

      • Modelo seleccionado: Después de seleccionar un modelo, se enumera aquí.

      • Buscar: Ingresa el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de modelos. La búsqueda no distingue mayúsculas de minúsculas. Si ya se muestran modelos en la tabla, los resultados de la tabla se filtran en tiempo real con cada pulsación de tecla. Para recargar modelos del punto de conexión durante la búsqueda, ingresa los criterios de búsqueda y luego actualiza, como se describe a continuación.

      • Actualizar: Haz clic en el icono de actualización o en la palabra Actualizar para recargar modelos del punto de conexión de Ollama. Esto puede ser útil si se han descargado modelos en un servidor Ollama auto-hospedado. Esta acción actualiza todos los metadatos utilizados para construir la tabla de modelos que se muestra en la configuración.

      • Seleccionar un modelo: En la tabla, haz clic en cualquier lugar de una fila para seleccionar un modelo. Solo se puede seleccionar un modelo. La información disponible para cada modelo se obtiene del punto de conexión de Ollama:

        • Nombre para mostrar: El nombre del modelo.

        • ID: El ID del modelo utilizado en solicitudes de API, incluyendo su etiqueta (por ejemplo, llama3.2:latest).

        • Modificado: La fecha y hora en que se modificó el modelo por última vez.

      Consejo

      Si la tabla no se completa con los modelos disponibles, es posible que la conexión de Ollama no sea exitosa. Asegúrate de estar conectado reabriendo la conexión y volviendo a probar las credenciales. Para un servidor Ollama auto-hospedado, también confirma que al menos un modelo se haya descargado en el servidor.

      Alternativamente, el modelo se puede especificar en el campo ID de modelo o proporcionarse en la transformación de solicitud. Si se especifica un modelo en varios lugares, se sigue este orden de precedencia:

      1. Un modelo proporcionado en la transformación de solicitud anula todos los campos a continuación.
      2. Un modelo especificado en el campo ID de modelo anula el campo restante a continuación, incluso si se selecciona Listar todos los modelos.
      3. Un modelo seleccionado en la lista Seleccionar un modelo tiene la menor precedencia.

  • Ingresa identificador de modelo: Selecciona esta opción para ingresar manualmente el ID de un modelo:

    • ID de modelo: Ingresa el ID del modelo (por ejemplo, llama3.2). Para Ollama Cloud, usa un nombre de modelo que aparezca en modelos en la nube de Ollama. Para un servidor auto-hospedado, el modelo ya debe estar descargado en el servidor.

  • Indicación: Opcionalmente, ingresa una indicación para enviarla al modelo después de registrar las herramientas. Si se proporciona una indicación, el modelo puede responder con llamadas de herramientas, que se devuelven en el campo toolCalls de la respuesta de la actividad.

  • Configuración opcional: Haz clic para expandir configuraciones opcionales adicionales:

    • Habilitar pensamiento (modelos de razonamiento): Selecciona para habilitar el pensamiento, que permite a un modelo de razonamiento reflexionar sobre un problema antes de generar una respuesta. El razonamiento del modelo se devuelve en el campo thinking de la respuesta. Esta opción se deshabilita de forma predeterminada. Cuando desactivas esta opción, se desactiva el pensamiento, incluso para modelos que de otro modo razonan por defecto.

      Nota

      El pensamiento solo es compatible con modelos de razonamiento. Consulta la documentación de pensamiento de Ollama para confirmar si el modelo seleccionado admite pensamiento.

  • Mantener modelo cargado: Selecciona cuánto tiempo el modelo permanece cargado en memoria después de que se completa la solicitud (consulta ¿Cómo mantengo un modelo cargado en memoria o lo descargo inmediatamente?). Mantener un modelo cargado evita el tiempo de carga en solicitudes posteriores, pero continúa usando memoria en el servidor Ollama:

    • 5 minutos: (Predeterminado.) Mantiene el modelo cargado durante 5 minutos.
    • 30 minutos: Mantiene el modelo cargado durante 30 minutos.
    • 1 hora: Mantiene el modelo cargado durante 1 hora.
    • Mantener cargado indefinidamente: Mantiene el modelo cargado hasta que se reinicie el servidor Ollama o se descargue el modelo.
    • Descargar después de cada llamada: Descarga el modelo inmediatamente después de que se devuelva la respuesta.

  • Aleatoriedad y diversidad:

    • Temperatura: Ingresa un parámetro de temperatura. Los valores más altos producen respuestas más variadas, y los valores más bajos producen respuestas más determinísticas. El valor de este parámetro puede oscilar entre 0 y 2, por ejemplo: 0.8.
    • Top P: Ingresa un parámetro Top P para muestreo de núcleo, que restringe la selección de tokens al conjunto más pequeño de tokens cuya probabilidad acumulada alcanza este valor. El valor de este parámetro puede oscilar entre 0 y 1, por ejemplo: 0.9.
    • Top K: Ingresa un parámetro Top K, que restringe la selección de tokens al número especificado de tokens con mayor probabilidad, por ejemplo: 40.
    • Semilla: Ingresa un parámetro de semilla. Usar el mismo valor de semilla con el mismo indicador reproduce la misma salida. Deja este campo vacío para una salida no determinística.

    Cuando un campo de este grupo está vacío, se utiliza el valor predeterminado del modelo.

  • Contexto y longitud:

    • Ventana de contexto: Ingresa el tamaño de la ventana de contexto en tokens, que limita la longitud combinada de la solicitud, el historial de conversación y la salida generada. El valor predeterminado es 4096. El valor máximo depende del modelo seleccionado y la memoria disponible en el servidor Ollama (consulta ¿Cómo puedo especificar el tamaño de la ventana de contexto?).
    • Tokens de salida máxima: Ingresa el número máximo de tokens a generar en la respuesta. El valor predeterminado es 2000. Ingresa -1 para generar sin límite.

  • Continuar en caso de error: Selecciona para devolver una respuesta con detalles del error en lugar de fallar la actividad cuando ocurra un error. El error se escribe en el registro de operaciones y se devuelve en el arreglo errors de la respuesta de la actividad.

  • Guardar y salir: Si está habilitado, haz clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

  • Siguiente: Haz clic para almacenar temporalmente la configuración de este paso y continuar al siguiente paso. La configuración no se guardará hasta que hagas clic en el botón Finalizado en el último paso.

  • Descartar cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje solicita que confirmes que deseas descartar los cambios.

Paso 2: Revisa los esquemas de datos

Se muestran todos los esquemas de solicitud o respuesta. A continuación, se describe cada elemento de la interfaz de usuario de este paso.

  • Esquema de datos: Estos esquemas de datos los heredan las transformaciones adyacentes y se muestran nuevamente durante el mapeo de transformaciones.

    Nota

    Los datos suministrados en una transformación tienen prioridad sobre la configuración de la actividad.

    En el esquema de solicitud, cada elemento en el arreglo tools define una herramienta con un name, una description y un arreglo arguments. Cada argumento tiene un name, un type, una description y una bandera isRequired. Los campos name y description son necesarios tanto para una herramienta como para sus argumentos.

El conector Ollama utiliza la API de Ollama. Consulta la documentación del endpoint de chat para obtener información sobre los nodos de esquema y los campos.

  • Actualizar: Haz clic en el icono de actualización o en la palabra Actualizar para regenerar esquemas desde el endpoint de Ollama. Esta acción también regenera un esquema en otras ubicaciones del proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.

  • Atrás: Haz clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

  • Finalizado: Haz clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.

  • Descartar cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Próximos pasos

Después de configurar una actividad Registrar herramientas de Ollama, completa la configuración de la operación agregando y configurando otras actividades, transformaciones o scripts como pasos de la operación. También puedes configurar los parámetros de la operación, que incluyen la capacidad de encadenar operaciones que se encuentran en el mismo flujo de trabajo o en flujos de trabajo diferentes.

Para completar un flujo de trabajo de llamada de herramientas, encadena una operación de Prompt para ejecutarse después de esta. Como Jitterbit almacena las definiciones de herramientas en memoria en el agente privado, la operación de Prompt las recibe automáticamente sin necesidad de mapeo adicional. Para vincular la operación de Prompt a esta conversación, configúrala con el mismo ID de chat o captura el chatId de la respuesta de Registrar herramientas y pásalo a la actividad de Prompt en la transformación de solicitud.

Las acciones de menú para una actividad son accesibles desde el panel del proyecto y el lienzo de diseño. Para obtener más detalles, consulta Menú de acciones de actividad en Conceptos básicos del conector.

Las actividades Registrar herramientas de Ollama se pueden utilizar como origen con estos patrones de operación:

Para utilizar la actividad con funciones de scripting, escribe los datos en una ubicación temporal y luego utiliza esa ubicación temporal en la función de scripting.

Cuando esté listo, implementa y ejecuta la operación y valida el comportamiento comprobando los registros de operación.