Versão 2.3.0#

Nova versão do Sherpa AI Server: Versão 2.3.0.

1. API atualizada#

A API do Sherpa AI Server foi atualizada: os métodos principais foram migrados para o formato atual /api/v1/.

Isso é importante para integrações e sistemas externos que acessam o Sherpa AI Server diretamente.

A documentação atual da API está disponível no Swagger:

swaggeraiserver.sherparpa.ru

2. Detalhes de auditoria aprimorados#

Na tela de Auditoria agora aparece o campo "Alterações" no cartão de registro. Ele mostra quais campos da entidade foram alterados, bem como os valores antigos e novos.

Os dados de alterações também estão disponíveis via API no campo "diff" para registros de auditoria, por exemplo na solicitação: GET /api/v1/audits/{audit_guid}.

Isso ajuda os administradores a entender rapidamente quais configurações ou dados foram alterados.

3. Suporte estendido de tipos de arquivo para indexação #

A indexação agora suporta mais formatos de documentos e arquivos de texto, incluindo .pdf, docx, .odt, .pptx, .ppt, .rtf, .epub, .html, .md, .csv, .json, .xml, .yaml, .toml, logs, arquivos de configuração e arquivos de código-fonte.

Isso ajuda os usuários a adicionar mais materiais de trabalho sem conversão manual prévia para formato de texto.

4. Avaliações de respostas do Assistente#

Botões de avaliação apareceram sob as respostas do Assistente na tela de Chat: "Curtir" e "Não curtir".

Os usuários podem avaliar a resposta do Assistente e adicionar um comentário se necessário. Ao clicar em "Curtir" ou "Não curtir", uma janela é aberta com o campo de comentário correspondente.

Após salvar, a avaliação selecionada é destacada em azul sob a resposta do Assistente.

As avaliações salvas podem ser visualizadas na tela de Histórico de chat. Uma coluna com estatísticas de avaliação de mensagem apareceu na tabela de histórico: número de curtidas, número de não curtidas, número total de avaliações e porcentagem de avaliações positivas.

Uma lista detalhada de avaliações está disponível na janela pop-up "Mostrar mensagem", que é aberta após clicar no botão de visualização de mensagem (com o ícone de lupa).

O diálogo aberto exibe informações da mensagem, e abaixo há uma tabela de avaliações. O tipo de avaliação é mostrado com um ícone de "Curtir" ou "Não curtir", com o comentário e a data de criação exibidos ao lado.

As avaliações também estão disponíveis via API:

• Criar uma avaliação de resposta do Assistente:

POST /api/v1/messages/{message_guid}/ratings

Exemplo de solicitação:

{
  "type": "like",
  "comment": "A resposta é útil e precisa"
}

• Obter a lista de avaliações para uma mensagem:

GET /api/v1/messages/{message_guid}/ratings

Exemplo de solicitação:

GET /api/v1/messages/7f6f1e8a-2d9c-4f6a-9c7e-123456789abc/ratings?pagination[per_page]=100

Na solicitação de criação de avaliação, o campo "type" é passado com o valor "like" para curtir ou "dislike" para não curtir.

A API retorna uma lista de avaliações com o tipo de avaliação, comentário e data de criação.

Filtragem por tipo de avaliação, ordenação e paginação também estão disponíveis.

5. Indicador de processamento de resposta#

Um indicador "Pensando…" apareceu no chat. Ele é exibido na área de resposta do Assistente enquanto o Sherpa AI Server processa a solicitação do usuário e prepara uma resposta.

Isso ajuda os usuários a entender que a solicitação foi aceita, o sistema não travou e a resposta ainda está sendo gerada. Isso é especialmente útil para solicitações longas, trabalho com arquivos e tarefas onde o processamento leva mais tempo.

6. Manuseio aprimorado de arquivos do Interpretador de código#

Na tela de Chat no Interpretador de código, o manuseio de arquivos foi aprimorado para arquivos que aparecem como resultado da execução de solicitações. As imagens criadas pelo Interpretador de código agora são exibidas diretamente no chat, sem abertura adicional ou download manual.

Isso ajuda a verificar rapidamente o resultado da execução do código, como um gráfico, diagrama ou outra imagem.

O botão "Baixar" para arquivos do Interpretador de código agora funciona de forma mais confiável. Os arquivos são baixados diretamente do navegador, sem bloqueio de pop-ups.

O erro que poderia causar falha nos downloads de arquivos do Interpretador de código com um erro de acesso negado também foi corrigido. Os links de download agora usam a rota correta, e o Sherpa AI Server determina corretamente o tipo de arquivo ao baixar: imagem, tabela, arquivo de texto, etc.

7. Suporte a fusos horários#

A API agora aceita datas no formato ISO 8601 com especificação de fuso horário, as armazena em um formato unificado e as retorna levando em conta o fuso horário da conta.

Isso ajuda a exibir corretamente o tempo no histórico de chat, filtros, licenças, execuções e outras seções onde o tempo exato do evento é importante. Fica mais fácil para usuários e administradores correlacionar eventos se estiverem trabalhando de diferentes fusos horários.

8. Filtragem de datas aprimorada#

Na tela de Histórico de chat, o formato de valores passados nos filtros de data foi atualizado. As datas agora são passadas com especificação explícita de fuso horário, para que a filtragem funcione com mais precisão e não desloque os limites do período.

Isso é especialmente importante para tabelas e relatórios, onde o usuário seleciona um período e espera ver todos os eventos para a data e hora selecionadas.

9. Dados de usuário estendidos na API#

A API de usuário agora retorna não apenas os dados básicos do usuário, mas também uma lista de suas funções.

Isso simplifica integrações e administração: sistemas externos podem ver imediatamente quais funções estão atribuídas a um usuário, sem solicitações adicionais.

10. Acesso refinado a Contas#

A lógica de acesso a Contas na API foi atualizada. Agora os usuários podem ver não apenas a Conta atual, mas também as Contas filhas (relacionadas).

Isso torna o trabalho com Contas mais seguro e ajuda a evitar mostrar dados desnecessários aos usuários.

11. Validação aprimorada de campos obrigatórios#

Se um usuário ou sistema externo não fornecer um campo obrigatório, como login, senha ou nome, a API agora retorna um erro de validação de dados claro em vez de um erro interno do servidor.

Isso ajuda a encontrar rapidamente o erro na solicitação e corrigi-lo sem acessar os logs do servidor.

12. Interface de Chat aprimorada#

Vários elementos da interface foram atualizados no Chat:

• O campo de entrada de mensagem agora se expande automaticamente à medida que o texto é digitado, até seis linhas.

Isso é conveniente para solicitações longas: o usuário vê mais texto antes de enviar.

• Os botões de ação nas mensagens ficaram mais visíveis ao passar o mouse.

Isso ajuda a encontrar rapidamente as ações "Copiar", "Excluir", "Editar" e "Baixar".

13. Diálogo de edição de usuário atualizado#

Na tela de Usuários no diálogo de edição de usuário, os parâmetros de notificação não utilizados foram removidos. A funcionalidade LDAP também foi aprimorada: a lista de usuários LDAP agora é carregada apenas quando o tipo de usuário correspondente é selecionado.

14. Scripts de instalação e atualização atualizados#

A documentação de instalação e atualização do Sherpa AI Server agora inclui métodos recomendados de instalação e atualização usando scripts prontos:

• install.sh;
• update.sh.

Os perfis de inicialização são listados separadamente: GPU, GPU2, CPU, Whisper, Reranker e perfil completo.

Isso ajuda os administradores a escolher rapidamente a opção de instalação ou atualização apropriada.

15. Imagem Docker atualizada para execução de código Python#

A distribuição agora inclui a construção automática da imagem Docker usada para executar código Python no modo interpretador de código.

Os administradores podem pré-construir ou baixar a imagem Docker pronta, transferi-la para um ambiente isolado e instalá-la sem acesso à Internet. Os scripts de construção, download e instalação offline foram atualizados para esse propósito.

Isso simplifica o trabalho em ambientes isolados onde as imagens Docker devem ser pré-construídas e transferidas manualmente.