Versão 2.6.0#
Uma nova versão do Sherpa AI Server está disponível: Versão 2.6.0.
Data de lançamento: 18 de novembro de 2026.
1. Antes da atualização#
Antes de atualizar, é necessário ler as notas de todas as versões intermediárias e cumprir seus requisitos. Se a versão atual for anterior à 2.5.0, combine o procedimento de atualização com a equipe de suporte.
Para usar as habilidades, é necessário atualizar a imagem Docker do serviço de interpretação de código junto com o servidor. Compilações próprias exigem uma base atualizada com packaging==24.0. Essa biblioteca verifica os requisitos dos pacotes Python. Uma base antiga sem ela não permite compilar o novo serviço.
Os componentes de processamento de dados atualizam suas dependências para corrigir vulnerabilidades. As correções são fornecidas nas imagens Docker correspondentes, que devem ser aplicadas durante a atualização.
2. Catálogo de habilidades e atribuição a assistentes#
O menu de navegação agora inclui Skills. É possível criar uma habilidade ou importar um ZIP com SKILL.md, scripts Python, modelos e outros recursos. O envio de um diretório de recursos preserva os caminhos relativos das subpastas. A pesquisa, os filtros do menu de colunas, a ordenação e a paginação ajudam a encontrar e reutilizar um pacote.
Agora uma habilidade pode ser atribuída a vários assistentes. Basta atualizar as instruções e os arquivos no catálogo para disponibilizar as alterações aos assistentes atribuídos. "All agents" abrange os assistentes atuais e futuros da conta e é configurado ao entrar como a conta.
A aba "Skills" da janela de edição do assistente agora oferece "Connect skill" com pesquisa dos pacotes disponíveis. As habilidades conectadas aparecem em cartões compactos com um interruptor de disponibilidade. As atribuições para toda a conta são indicadas separadamente. Usuários com permissão de leitura podem consultar instruções e baixar recursos. A edição e a conexão exigem permissão de atualização de assistentes. Isso permite reutilizar instruções sem alterar as restrições das pastas de objetos.

Janela Edit assistant, aba Skills, interface em inglês
Não é necessário ativar a função por outra variável de ambiente. A preparação do pacote e as permissões estão descritas no guia de habilidades de assistentes.
3. Habilidades no chat#
Os chats com um assistente agora oferecem seleção automática de habilidades conforme a tarefa nos modos "Agent" e "Code interpreter". Para o uso habitual, basta enviar uma solicitação. Para escolher uma habilidade manualmente, abra o menu de ferramentas no canto inferior esquerdo do campo de entrada, escolha "Skills" e clique no título do pacote na janela separada. Uma etiqueta compacta mostra a habilidade selecionada. Removê-la restaura a seleção automática e preserva o rascunho. Não há mais um campo separado acima da entrada, e o modo do chat não muda.

Chat, entrada no modo Agent, Monthly report selecionada, interface em inglês
As instruções são enviadas completas ao modelo. Se o catálogo e as instruções excederem o contexto disponível, o servidor informa o limite. É necessário reduzir as descrições ou as instruções, ou escolher um modelo com contexto adequado. Os requisitos de pacotes Python são verificados antes da execução. Nomes de pacotes e requisitos de versão inválidos são rejeitados antes de salvar a habilidade. A ausência de uma biblioteca gera um aviso. Se a verificação estiver indisponível, aparece "Compatibility not checked". As habilidades não instalam bibliotecas automaticamente. Pacotes instalados de wheels locais ou URLs diretas são reconhecidos pelo nome e pela versão reais.
No primeiro uso bem-sucedido, a execução mantém uma versão das instruções e dos recursos. Os arquivos da habilidade são somente leitura para Python. Editar um pacote não substitui os materiais já carregados pela execução atual. O acesso ao assistente e à habilidade é verificado novamente, inclusive após uma mudança de pasta de objetos ou a desativação de uma atribuição. Após a conclusão ou o cancelamento, as cópias temporárias são removidas em segundo plano, preservando os recursos das execuções ativas e os documentos gerados no chat.
4. Capacidades e atribuições padrão de modelos#
A tela Models agora oferece capacidades independentes de OCR de documentos, análise de imagens, vídeo e outras operações. No cartão do modelo, o administrador pode testar as capacidades usando uma instância ativa salva e selecionar as operações para as quais o modelo será padrão. Assim, o OCR de documentos e o processamento de imagens podem ser configurados separadamente.

Janela "Edit Model", capacidades independentes e atribuições padrão
As verificações de capacidades são consistentes no chat, Chat Completions e Responses, inclusive nas respostas transmitidas gradualmente. As solicitações usam modelos da conta atual. Se uma atribuição padrão estiver ausente ou uma instância indisponível for especificada, o servidor retorna um erro claro em vez de escolher silenciosamente uma conexão do ambiente.
Em um novo chat sem assistente, agora é possível selecionar o modelo antes da primeira mensagem. Isso permite iniciar a conversa com o modelo desejado.
5. Migração da indexação do ambiente para Models#
Ao atualizar uma conta com uma conexão de indexação antiga definida no ambiente, o servidor a transfere para um modelo de indexação padrão. Os vetores existentes e as transições pendentes são preservados. Essa migração não exige reindexação. A atribuição pode ser conferida nas configurações de Documents. Os segredos do servidor não são copiados para os cartões de modelos.
Foi adicionado o script de administração scripts/import-account-models-from-env.php para importar outras conexões do ambiente para uma conta selecionada explicitamente. Por padrão, ele apresenta um plano sem alterar dados. A aplicação usa --apply com o --account-guid obrigatório. Assim, o administrador pode conferir a migração proposta antes de salvar as configurações.
A troca do modelo de indexação continua sendo uma operação separada que exige confirmação, conforme o guia de indexação. Remover a atribuição padrão preserva os vetores existentes, mas interrompe novas operações de indexação até a seleção de outro modelo. Isso diferencia a migração de uma conexão existente da troca para outro modelo.
6. Separação de falantes em gravações#
A opção "Also perform diarization" do cartão do modelo de transcrição agora controla a separação de falantes também quando um modelo é selecionado explicitamente. A opção aparece abaixo da transcrição ativada e é salva por instância, independentemente da atribuição padrão.

Janela "Edit Model", diarização ativada
Gravações com vários falantes são processadas pelo WhisperX mesmo quando Whisper está selecionado para a transcrição habitual. Se a diarização estiver indisponível, o servidor informa um erro em vez de retornar silenciosamente texto sem identificar os falantes. Isso permite obter a transcrição esperada ou identificar a configuração que precisa ser verificada.
7. Envio de pastas e arquivos ZIP para Documents#
A tela Documents agora oferece envio de pastas e importação de ZIP como pasta. Ambas as opções preservam a estrutura de subpastas. Os arquivos da raiz do ZIP são colocados diretamente na pasta selecionada. A importação verifica os caminhos e os limites de extração. Assim, uma estrutura preparada pode ser importada sem criar cada pasta manualmente.
Para manter o ZIP como um único arquivo sem extraí-lo, é necessário usar o envio comum de arquivos.
8. Colunas adicionais de Documents#
A tabela Documents agora permite colunas "Text", "Number" e "List". Os valores informados no cartão de um arquivo aparecem ao lado do documento na tabela e nos resultados de pesquisa. Por exemplo, é possível salvar o número e o departamento de cada contrato para consultar essas informações ao selecionar o arquivo.
9. Apresentação de arquivos, pastas e tags#
As listas de arquivos e pastas agora têm mais espaço entre o ícone de cada arquivo ou pasta e seu nome. Ao editar uma tag, o campo de nome ativo tem um fundo claro. Isso ajuda a distinguir nomes adjacentes e localizar o campo em edição.
10. Exportação de eventos de Audit para SIEM#
Foi adicionado um exportador Syslog separado e opcional para enviar eventos de Audit ao SIEM. O administrador pode ativar o perfil siem e configurar um destinatário para reunir os eventos do Sherpa AI Server com os de outros sistemas. O progresso de leitura é salvo separadamente. As verificações repetidas incluem registros de transações concluídas com atraso.
Os passos de conexão, as permissões do banco de dados e as configurações TLS estão no guia de exportação. É necessário considerar as limitações do protocolo: o envio por TCP/TLS não confirma o armazenamento no SIEM, e UDP não confirma a entrega.
11. Preservação de rascunhos e recuperação de habilidades#
O editor de habilidades agora trata corretamente a edição simultânea. Se a versão salva mudar, o rascunho local permanece na janela e a substituição é bloqueada. Para continuar, é necessário salvar separadamente o texto desejado, carregar a versão atual com "Reopen skill" e reaplicar as alterações. Atualizar a lista e realizar operações com arquivos não remove mais essa proteção.
Quando a falha de importação de um ZIP é confirmada, os arquivos criados para essa importação são removidos. A contagem de arquivos em ZIPs com diretórios aninhados também foi corrigida.
O recarregamento após uma falha do interpretador restaura os recursos da execução atual. Ao retomar um agente, as atribuições e permissões são verificadas novamente. Habilidades desativadas ou desvinculadas são excluídas das instruções atuais. Assim, o trabalho pode continuar sem instruções desatualizadas nem recursos de outra execução.
Uma nova tentativa após erro de envio à fila restaura o rascunho original sem repetir o comando da habilidade. Um erro atrasado não substitui mais o texto de outro chat, modo ou execução.
12. Diagnóstico de capacidades do modelo#
A tela Models agora mostra corretamente as falhas na detecção de capacidades. O motivo e o código HTTP podem ser copiados diretamente da janela "Edit Model". A lista ficou mais compacta, e os botões longos ocupam mais de uma linha em telas estreitas. Isso permite consultar o resultado e continuar a configuração sem procurar uma notificação que desapareceu.

Janela "Edit Model", detalhes do erro e código HTTP
Após a confirmação de um modelo de indexação, fechar seu cartão atualiza a lista Models, inclusive com Cancel ou Escape. O administrador vê a atribuição padrão atual sem recarregar a página.
13. Gravação e exibição de colunas adicionais#
Documents agora atualiza corretamente as colunas adicionais após a resposta do servidor e mostra os valores salvos nos resultados de pesquisa. Após um erro de gravação, o valor pode ser enviado novamente. Trocar "List" por "Text" ou "Number" não é mais bloqueado por uma opção vazia oculta.
Fechar a janela de exclusão de colunas cancela a ação. Um erro libera o estado pendente. Assim, é possível continuar trabalhando com a tabela e repetir a ação desejada.
14. Download de anexos e ferramentas do agente#
O download de XLSX e outros anexos do chat agora remove os espaços excedentes ao final do nome do arquivo. O início do nome é preservado. Os arquivos são baixados com os nomes esperados, sem aumentar artificialmente seu comprimento.
Se um arquivo dos resultados do interpretador não puder ser obtido, os demais arquivos disponíveis são salvos no chat. Uma falha não interrompe mais a gravação de todos os resultados.
No modo "Agent", foram corrigidos o envio do token API selecionado às ferramentas internas e o formato do corpo das solicitações. As chamadas usam esse token para executar as solicitações com as permissões configuradas.
15. Autorização da Chat API e páginas de API#
Chat Completions e Responses agora classificam corretamente as solicitações sem dados de autorização. Em vez de um erro de estrutura JSON, retornam 403 access_denied com orientação sobre Bearer ou uma sessão. A integração deve fornecer uma chave API válida em Authorization: Bearer … ou usar uma sessão válida. Isso permite corrigir a autenticação sem alterar um corpo de solicitação correto. As verificações de autenticidade da chave e de permissões para a operação são preservadas.
Foi corrigida a abertura da página de tokens API, Swagger e ReDoc em instalações nas quais seus arquivos eram tratados como solicitações à API. A seleção comum da entrada do menu volta a abrir a página.