Adicionando um provedor de IA personalizado

Os editores do ONLYOFFICE permitem que você adicione um provedor de IA personalizado e o configure de acordo com suas preferências.

Pré-requisitos

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

1. Obtenha as credenciais necessárias do provedor de sua escolha:

   • URL base: O endereço web para o qual as solicitações de API são enviadas. Em alguns casos, a URL base pode incluir um endpoint que especifica o modelo usado, por exemplo:

     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 está incluída na URL base, por exemplo, v1 na seguinte URL:

     https://api.moonshot.cn/v1

   • Chave de 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 a partir desse arquivo são instâncias da classe Provider, que estende AI.Provider. Essa classe gerencia todos os provedores disponíveis no 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 = [];
    }
}

Vamos ver a implementação do serviço Tongyi Qianwen como exemplo:

"use strict";

class Provider extends AI.Provider {

    constructor() {
        super("Alibaba 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 web para o qual estamos enviando a solicitação de API.
• yourAPIKey é a chave de API emitida pelo provedor.
• v1 é a versão do modelo para a qual estamos enviando a solicitação de API.

Adicionando um provedor personalizado

1. Clique com o botão direito em qualquer palavra selecionada e navegue até IA → Configurações no menu de contexto.
2. Na janela Configuração de IA, selecione Editar modelos de IA.
3. Na janela Lista de modelos de IA, clique no ícone de lápis para editar os modelos.
4. Na janela Editar modelo de IA, clique em Provedores personalizados no canto inferior esquerdo da janela.
5. Clique no ícone de mais e carregue o arquivo JavaScript que contém as configurações do seu provedor personalizado.
6. Clique em Voltar para sair da janela Adicionar modelo de IA.
7. Selecione seu provedor personalizado na lista da janela Adicionar modelo de IA e clique em OK.
8. Clique em Voltar para sair da janela Lista de modelos de IA.
9. Defina o modelo do seu provedor personalizado para uma tarefa específica na janela Configuração de IA.