Como adicionar um provedor personalizado ao plugin de IA do ONLYOFFICE

28 março 2025Por Klaibson

Com o lançamento do plugin de IA do ONLYOFFICE, aprimoramos significativamente a funcionalidade padrão dos nossos editores. No ONLYOFFICE, estamos comprometidos em fornecer soluções poderosas e flexíveis que se adaptam às suas necessidades específicas. Uma delas é a opção de adicionar qualquer provedor personalizado ao nosso plugin de IA. Nesta postagem do blog, demonstraremos como integrar os serviços Tongyi Qianwen e Kimi ao plugin de IA, fornecendo um guia passo a passo durante o processo.

Como adicionar um provedor personalizado ao plugin de IA do ONLYOFFICE

Sobre Tongyi Qianwen e Kimi

Alibaba Cloud Tongyi Qianwen e Kimi são modelos avançados de linguagem de IA projetados para processamento de linguagem natural e geração de texto.

  • Tongyi Qianwen, desenvolvido pela Alibaba Cloud, é um poderoso modelo de linguagem de grande porte que oferece suporte a vários aplicativos baseados em IA, incluindo criação de conteúdo, chatbots e soluções empresariais.
  • Kimi, criado pela Moonshot AI, é outro grande modelo de linguagem conhecido por sua eficiência em lidar com consultas complexas, gerar texto semelhante ao humano e auxiliar em diversas tarefas.

Ambos os modelos oferecem recursos robustos de IA, tornando-os adequados para integração ao plugin ONLYOFFICE AI para aprimorar a edição e a automação de documentos.

Pré-requisitos

Antes de adicionar um provedor personalizado, certifique-se de concluir as seguintes etapas:

  1. Obtenha as credenciais necessárias: recupere a URL base, a versão do modelo e a chave de API do provedor escolhido.
  2. Crie um arquivo JavaScript dedicado: armazene a URL base, a versão do modelo e a chave da API em um arquivo JavaScript separado.

Antes de integrar um provedor personalizado, vamos detalhar as principais credenciais que você precisará:

  • URL base: Este é o endereço da web para onde as solicitações de API são enviadas. Em alguns casos, a URL base pode incluir um ponto de extremidade que especifica o modelo que está sendo usado:
 https://dashscope.aliyuncs.com/compatible-mode/
  • Versão do modelo: identifica a versão do modelo que você está acessando. Às vezes, a versão do modelo é incluída na URL base:
https://api.moonshot.cn/v1

Neste exemplo, a versão do modelo é v1.

  • Chave API: Uma chave exclusiva fornecida pelo provedor de serviços, usada para autenticação.

Criando o arquivo JavaScript externo

Para adicionar um provedor personalizado e exibi-lo na lista de provedores disponíveis no plugin de IA, você precisa criar e carregar um arquivo JS externo.

Os provedores personalizados analisados ​​neste arquivo são instâncias da classe Provider , que estende AI.Provider. Esta classe gerencia todos os provedores disponíveis dentro do plugin.

Abaixo estão os parâmetros da classe 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 = [];
        }

Agora vamos dar uma olhada em nossa implementação para o serviço Tongyi Qianwen:

"use strict";


class Provider extends AI.Provider {


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


}

Onde:

  • Alibaba Cloud: o nome do provedor que será exibido no plugin.
  • https://dashscope.aliyuncs.com/compatible-mode: o endereço da web para o qual estamos enviando a solicitação de API.
  • yourAPIKeya chave de API emitida pelo provedor.
  • v1: a versão do modelo para o qual estamos enviando a solicitação de API.

A implementação do serviço Kimi é a seguinte:

"use strict";


class Provider extends AI.Provider {


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


}

Adicionando o provedor personalizado

  • Clique com o botão direito em qualquer palavra selecionada e navegue até IA > Configurações.

Como adicionar um provedor personalizado ao plugin de IA do ONLYOFFICE

  • Na janela Configuração de IA, selecione Editar modelos de IA.

Como adicionar um provedor personalizado ao plugin de IA do ONLYOFFICE

  • Na janela da lista de modelos de IA, clique no ícone de lápis para editar modelos.

Como adicionar um provedor personalizado ao plugin de IA do ONLYOFFICE

  • Na janela Editar modelo de IA, clique em provedores personalizados.

Como adicionar um provedor personalizado ao plugin de IA do ONLYOFFICE

  • Clique no ícone de adição e carregue o arquivo JavaScript contendo suas configurações personalizadas do provedor.

Como adicionar um provedor personalizado ao plugin de IA do ONLYOFFICE

  • Clique em Voltar para sair da janela Adicionar modelo de IA.

Como adicionar um provedor personalizado ao plugin de IA do ONLYOFFICE

  • Selecione seu provedor personalizado na lista na janela Adicionar modelo de IA e clique em OK.

Tongyi Qianwen:

Como adicionar um provedor personalizado ao plugin de IA do ONLYOFFICE

Kimi:

Como adicionar um provedor personalizado ao plugin de IA do ONLYOFFICE

  • Clique em Voltar para sair da janela da lista de modelos de IA.

Como adicionar um provedor personalizado ao plugin de IA do ONLYOFFICE

  • Defina seu modelo de provedor personalizado para uma tarefa específica na janela Configuração de IA.

Como adicionar um provedor personalizado ao plugin de IA do ONLYOFFICE

Após concluir essas etapas, o plugin de IA estará totalmente configurado e pronto para auxiliar em uma ampla variedade de tarefas!

Na ONLYOFFICE, estamos comprometidos em fornecer funcionalidade versátil que atenda às suas necessidades específicas. Este novo recurso reflete nossa dedicação à inovação. Esperamos que este tutorial ajude você a configurar seu provedor personalizado com facilidade. Se você tiver alguma dúvida ou sugestão, sinta-se à vontade para fazer contato, agradecemos seu feedback e colaboração!

Crie sua conta gratuita no ONLYOFFICE

Visualize, edite e colabore em documentos, planilhas, slides, formulários e arquivos PDF online.