Cómo agregar un proveedor personalizado al plugin de IA de ONLYOFFICE

28 marzo 2025Por Dea

Con el lanzamiento del plugin de IA de ONLYOFFICE, hemos mejorado significativamente la funcionalidad predeterminada de nuestros editores. En ONLYOFFICE, nos comprometemos a ofrecer soluciones poderosas y flexibles que se adapten a tus necesidades específicas. Una de estas opciones es la posibilidad de agregar cualquier proveedor personalizado a nuestro plugin de IA. En este artículo, mostramos cómo integrar los servicios de Tongyi Qianwen y Kimi en el plugin de IA, proporcionando una guía paso a paso sobre el proceso.

Cómo agregar un proveedor personalizado al plugin de IA de ONLYOFFICE

Sobre Tongyi Qianwen y Kimi

Alibaba Cloud Tongyi QianwenKimi de Moonshot AI son modelos avanzados de procesamiento de lenguaje natural y generación de texto.

  • Tongyi Qianwen, desarrollado por Alibaba Cloud, es un potente modelo de lenguaje grande que admite diversas aplicaciones impulsadas por IA, incluyendo la creación de contenido, chatbots y soluciones empresariales.
  • Kimi, creado por Moonshot AI, es otro modelo de lenguaje grande conocido por su eficiencia en el manejo de consultas complejas, generación de texto similar al humano y asistencia en varias tareas.

Ambos modelos ofrecen capacidades robustas de IA, lo que los hace adecuados para integrarse en el plugin de IA de ONLYOFFICE para mejorar la edición de documentos y la automatización.

Requisitos previos 

Antes de agregar un proveedor personalizado, asegúrate de completar los siguientes pasos:

  1. Obtén las credenciales necesarias: Obtén la URL base, la versión del modelo y la clave de la API de tu proveedor elegido.
  2. Crea un archivo JavaScript dedicado: Guarda la URL base, la versión del modelo y la clave de la API en un archivo JavaScript separado.

Antes de integrar un proveedor personalizado, desglosamos las credenciales clave que necesitarás:

  • URL base: Esta es la dirección web a la que se envían las solicitudes de la API. En algunos casos, la URL base puede incluir un punto final que especifique el modelo que se está utilizando:
 https://dashscope.aliyuncs.com/compatible-mode/
  • Versión del modelo: Esto identifica la versión del modelo al que estás accediendo. A veces, la versión del modelo se incluye en la URL base:
https://api.moonshot.cn/v1

En este ejemplo, la versión del modelo es v1.

  • Clave de la API: Una clave única proporcionada por el proveedor del servicio, utilizada para la autenticación.

Creando el archivo Java Script externo

Para agregar un proveedor personalizado y mostrarlo en la lista de proveedores disponibles dentro del plugin de IA, necesitas crear y subir un archivo JS externo.

Los proveedores personalizados analizados desde este archivo son instancias de la clase Provider, que extiende IA.Provider. Esta clase gestiona todos los proveedores disponibles dentro del plugin.

A continuación, se presentan los parámetros de la clase Provider:

class Provider {
        /**
         * Provider base class.
         * @param {string} name  Provider name.
         * @param {string} url   Url to service.
         * @param {string} key   Key for service. This is an optional field. Some providers may require a key for access.
         * @param {string} addon Addon for url. For example: v1 for many providers. 
         */
        constructor(name, url, key, addon) {
            this.name  = name  || "";
            this.url   = url   || "";
            this.key   = key   || "";
            this.addon = addon || "";
    
            this.models = [];
            this.modelsUI = [];
        }

Ahora echemos un vistazo a nuestra implementación para el servicio de Tongyi Qianwen:

"use strict";


class Provider extends AI.Provider {


    constructor() {
        super("Alibab Cloud", "https://dashscope.aliyuncs.com/compatible-mode", "yourAPIKey", "v1");
    }


}

Donde:

  • Alibaba Cloud: el nombre del proveedor que se mostrará en el plugin.
  • https://dashscope.aliyuncs.com/compatible-mode: la dirección web a la que enviamos la solicitud de la API.
  • yourAPIKey: la clave de la API proporcionada por el proveedor
  • v1: la versión del modelo a la que enviamos la solicitud de la API.

La implementación para el servicio de Kimi es la siguiente:

"use strict";


class Provider extends AI.Provider {


    constructor() {
        super("Kimi", " https://api.moonshot.cn", "yourAPIkey", "v1");
    }


}

Cómo agregar el proveedor personalizado

  • Haz clic derecho sobre cualquier palabra seleccionada y navega a IA > Ajustes.

Cómo agregar un proveedor personalizado al plugin de IA de ONLYOFFICE

  • En la ventana Ajustes de IA, selecciona Editar modelos de IA.

Cómo agregar un proveedor personalizado al plugin de IA de ONLYOFFICE

  • En la ventana Lista de modelos de IA, haz clic en el ícono de lápiz para editar los modelos.

Cómo agregar un proveedor personalizado al plugin de IA de ONLYOFFICE

  • En la ventana Editar modelo de IA, haz clic en Proveedores personalizados.

Cómo agregar un proveedor personalizado al plugin de IA de ONLYOFFICE

  • Haz clic en el ícono de más (+) y sube el archivo Java Script que contiene la configuración de tu proveedor personalizado.

Cómo agregar un proveedor personalizado al plugin de IA de ONLYOFFICE

  • Haz clic en Volver para salir de la ventana Agregar modelo de IA.

Cómo agregar un proveedor personalizado al plugin de IA de ONLYOFFICE

  • Selecciona tu proveedor personalizado de la lista en la ventana Añadir modelo de IA y haz clic en OK.

Tongyi Qianwen:

Cómo agregar un proveedor personalizado al plugin de IA de ONLYOFFICE

Kimi:

Cómo agregar un proveedor personalizado al plugin de IA de ONLYOFFICE

  • Haz clic en Volver para salir de la ventana de la lista de modelos de IA.

Cómo agregar un proveedor personalizado al plugin de IA de ONLYOFFICE

  • Configura el modelo de tu proveedor personalizado para una tarea específica en la ventana Configuración de IA.

Cómo agregar un proveedor personalizado al plugin de IA de ONLYOFFICE

Después de completar estos pasos, ¡el plugin de IA estará completamente configurado y listo para ayudarte con una amplia variedad de tareas!

En ONLYOFFICE, estamos comprometidos a ofrecer una funcionalidad versátil que satisfaga tus necesidades específicas. Esta nueva función refleja nuestro compromiso con la innovación. Esperamos que este tutorial te ayude a configurar tu proveedor personalizado con facilidad. Si tienes alguna pregunta o sugerencia, no dudes en contactarnos, ¡valoramos tus comentarios y colaboración!

Crea tu cuenta gratuita de ONLYOFFICE

Visualiza, edita y colabora en documentos, hojas, diapositivas, formularios y archivos PDF en línea.