# Modelos A tela "Modelos", dividida em "Modelos" e "Instâncias de Modelos", oferece a possibilidade de conectar um modelo adicional ao Sherpa AI Server, desde que haja recursos de hardware adequados.

Os usuários podem escolher entre um modelo local ou em nuvem, desde que tenham os tokens necessários para acesso. Também é possível integrar um modelo hospedado em servidores externos dentro da rede local, mas não no mesmo servidor onde está localizado o Sherpa AI Server. Em nosso sistema, foi implementado um algoritmo que verifica a disponibilidade dos modelos e responde ao primeiro disponível. No entanto, se for necessário usar um modelo específico, podemos simplesmente criar uma instância desse modelo no grupo correspondente, e ele funcionará com ela constantemente. Vale ressaltar que, devido à funcionalidade de agrupamento, na verdade agrupamos não os próprios modelos, mas seus backends, o que garante escalabilidade e resiliência do sistema. Dentro de um grupo, não é proibido hospedar vários backends com diferentes modelos. A seção "Modelos" permite criar e editar grupos de modelos. A seção "Instâncias de Modelos" permite criar diferentes links para modelos. Para cada modelo, é possível configurar conexões separadas, cada uma com seus parâmetros e configurações individuais.


Nº	Elemento da Interface	Descrição
	Tabela "Modelos"
1.	botão "Criar"	Permite criar novos grupos de modelos.
2.	botão "Atualizar"	Permite atualizar forçadamente a tabela "Modelos".
3.	botão "Excluir Selecionados"	Permite excluir grupos de modelos selecionados do Sherpa AI Server. Também é possível excluir grupos de modelos individuais, clicando no botão na linha desejada da tabela Modelos. Ao excluir um grupo de modelos, aparece uma janela para confirmar a exclusão.
4.	botão "Exportar para CSV"	Gera um arquivo de dados dos grupos de modelos no formato CSV (Comma-Separated Values) para importação em planilhas e sistemas de contabilidade.
5.	botão "Exportar para XLSX"	Gera um arquivo de dados dos grupos de modelos no formato Microsoft Excel (XLSX) para importação em planilhas e sistemas de contabilidade.
	Tabela "Instâncias de Modelos"
1.	botão "Criar"	Permite criar instâncias de modelos.
2.	botão "Atualizar"	Permite atualizar forçadamente a tabela "Instâncias de Modelos".
3.	botão "Excluir Selecionados"	Permite excluir instâncias de modelos selecionadas do Sherpa AI Server. Também é possível excluir instâncias de modelos individuais, clicando no botão na linha desejada da tabela "Regras". Ao excluir instâncias de modelos, aparece uma janela para confirmar a exclusão.
4.	botão "Exportar para CSV"	Gera um arquivo de dados das instâncias de modelos no formato CSV para importação em planilhas e sistemas de contabilidade.
5.	botão "Exportar para XLSX"	Gera um arquivo de dados das instâncias de modelos no formato Microsoft Excel (XLSX) para importação em planilhas e sistemas de contabilidade.

## Seleção de Modelo em outras telas do Sherpa AI Server ### Chat A seção "Modelos" permite visualizar e editar grupos de modelos, que posteriormente o Usuário poderá escolher ao [criar um novo diálogo](https://docs.sherparpa.ru/pt/sherpa-ai/sherpa-ai-server/rabota-v-sherpa-ai-server/chat) no Sherpa AI Server.

### Assistentes A seção "Modelos" permite visualizar e editar grupos de modelos, que posteriormente o Usuário poderá escolher ao criar um [Assistente](https://docs.sherparpa.ru/pt/sherpa-ai/sherpa-ai-server/rabota-v-sherpa-ai-server/assistenty).

## Criar modelo Para criar um novo grupo de modelos, é necessário clicar no botão "Criar" na tabela "Modelos" e preencher o formulário que se abrirá.

## Criar instância Para criar uma nova instância de modelo, é necessário clicar no botão "Criar" na tabela "Instâncias de Modelos" e preencher o formulário que se abrirá.

Os campos a serem preenchidos na janela pop-up "Criar Instância": * "Nome \*" – campo obrigatório para o nome da instância do modelo; * "Descrição" – campo para inserir a descrição da instância do modelo; * "Host \*" – campo obrigatório para indicar o endereço IP ou nome de domínio do servidor onde a instância do modelo está hospedada; * "Porta \*" – campo obrigatório para indicar o número da porta do serviço da instância do modelo; * "Protocolo \*" – campo obrigatório para escolher o protocolo de conexão; * "Timeout \*" – campo obrigatório para definir o tempo máximo de espera pela resposta da instância do modelo (em segundos). Também é possível criar conexões com modelos em nuvem (selecionando a caixa de seleção "Nuvem" na janela "Criar Instância"). Para isso, são fornecidas configurações especiais, incluindo servidores proxy e tokens de acesso adicionais. No caso de modelos locais, a configuração inclui a indicação do host, porta e protocolo. O protocolo permanece sendo o nosso padrão, semelhante ao formato OpenAI, garantindo uniformidade e compatibilidade ao trabalhar com diferentes modelos.

Campos adicionais a serem preenchidos na janela pop-up "Criar Modelos" (ao selecionar a caixa de seleção "Nuvem" na janela "Criar Instância"): * "Provedor \*" – campo para escolher o fornecedor do modelo; * "Modelo do fornecedor" – campo para indicar o modelo específico do fornecedor escolhido; * "Token / API Key \*" – campo para inserir a chave de API ou token de autorização do fornecedor; * "Login" – campo para inserir o nome de usuário (ao usar autenticação básica); * "Senha" – campo para inserir a senha (ao usar autenticação básica). Este é um contêiner especial, destinado a executar um único modelo. Na prática, ele é uma plataforma universal na qual qualquer modelo pode ser executado, mas apenas um de cada vez. Para usar vários modelos, basta iniciar vários desses contêineres, cada um com sua configuração. Nesse caso, em cada contêiner, será necessário alterar a porta pela qual se acessa o modelo. Essa abordagem permite utilizar eficientemente um único servidor, executando nele qualquer número de modelos (a limitação depende apenas dos recursos de hardware). ## Editar modelo Para visualizar e editar as propriedades de um grupo de modelos, é necessário selecionar o grupo desejado na lista e clicar no botão ![](https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-dc74b7a07745f14c6ce68ae542872c3b70988ebe%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20\(70\).png?alt=media). Após isso, abrirá um formulário com as configurações do modelo, no qual é possível fazer as alterações necessárias. Não há novos campos no modelo criado anteriormente.

## Editar instânciaPara visualizar e editar as propriedades da instância do modelo, é necessário selecionar a instância desejada na lista e clicar no botão ![](https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-dc74b7a07745f14c6ce68ae542872c3b70988ebe%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20\(70\).png?alt=media). Após isso, um formulário com as configurações da instância do modelo será aberto, onde você pode fazer as alterações necessárias. Não há novos campos na instância do modelo criada anteriormente.

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.sherparpa.ru/pt/sherpa-ai/sherpa-ai-server/rabota-v-sherpa-ai-server/modeli.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.