Python agent release notesRSS

Notas

Esta versão do agente Python adiciona suporte a trace/span para o Agente Híbrido, a integração da New Relic com o OpenTelemetry. Também adiciona GUIDs de entidade aos arquivos de verificação de integridade do Agent Control, atributos subcomponent à instrumentação de IA agêntica, suporte a novos métodos de cliente Redis, corrige um bug onde pode haver instâncias duplicadas do ImportHookFinder e um bug na instrumentação do OracleDB Cursor.callproc().

Instale o agente usando easy_install/pip/distribute através do Índice de Pacotes Python, usando conda através do Índice de Pacotes Conda-Forge ou baixe-o diretamente do site de download do New Relic.

Recurso

• Adicionar suporte ao rastreamento do Agente Híbrido

  • O Hybrid Agent foi projetado para preencher a lacuna para equipes que buscam adotar os padrões OpenTelemetry, mantendo a retrocompatibilidade com seus dashboards existentes do New Relic. O Hybrid Agent oferece uma experiência do "melhor dos dois mundos" ao combinar a visibilidade profunda da New Relic com a compatibilidade da API OpenTelemetry. Fornece uma solução de observabilidade com suporte integrado para as seguintes APIs do OpenTelemetry:

    • Rastreamento
    • Instrumentação de biblioteca autônoma e framework nativo

  • Principais melhorias como Span Links e Events on Spans estão agora disponíveis, garantindo interoperabilidade perfeita em ambientes de modo misto.

• Introduz um novo amostrador baseado na proporção de Trace ID

  • Um novo amostrador baseado na proporção de Trace ID. Este algoritmo de amostragem baseia-se no amostrador de mesmo nome do OpenTelemetry e pode ser configurado para amostrar uma porcentagem definida de transações.

• Adicionar subcomponent atributos à instrumentação de IA agêntica

  • A instrumentação para LangChain, MCP e Strands agora inclui um atributo subcomponent em spans que representam chamadas de ferramenta ou agente. Isso é usado para fornecer um mapeamento de entidades aprimorado na interface do usuário do New Relic.

• Adicionar o GUID da entidade aos arquivos de verificação de integridade do Agent Control

  • Quando o agente é iniciado em um ambiente de Controle do Agente, um arquivo de verificação de integridade é criado no local de arquivo configurado para cada processo do agente. Este arquivo agora inclui o GUID da entidade relacionada ao agente quando disponível.

• Adicionar instrumentação para novos métodos do Redis

  • Adicione instrumentação para os seguintes novos métodos nos clientes Redis:

    • hotkeys_get
    • redefinir_atalhos
    • hotkeys_start
    • Parar teclas de atalho
    • vrange
    • xcfgset

Bugs

• Corrigir instâncias duplicadas do ImportHookFinder

  • Anteriormente, era possível que duplicatas do localizador de gancho de importação fossem adicionadas a sys.meta_path.

• Corrigir assinatura incorreta no OracleDB Cursor.callproc()

  • Anteriormente, tentar usar argumentos nomeados com Cursor.callproc() causava falhas, pois os nomes dos argumentos estavam incorretos em nossa instrumentação. Isso foi corrigido, e o argumento adicional keyword_parameters agora também é suportado.

Declaração de apoio

Recomendamos atualizar para a versão mais recente do agente assim que estiver disponível. Se você não puder atualizar para a versão mais recente, atualize seu agente para uma versão com no máximo 90 dias. Saiba mais sobre como manter o agente atualizado.

Consulte a New Relic Python política de fim de vida útil do agente para obter informações sobre lançamentos de agentes e datas de suporte.

Notas

Esta versão do agente Python adiciona suporte a agentes LangGraph.

Instale o agente usando easy_install/pip/distribute através do Índice de Pacotes Python, usando conda através do Índice de Pacotes Conda-Forge ou baixe-o diretamente do site de download do New Relic.

Recurso

• Adicionar suporte a agentes LangGraph

  • Adiciona instrumentação para invocações de agente LangGraph via create_agent() no LangChain. Isso inclui chamadas do agente para invoke(), ainvoke(), stream() e astream().

Declaração de apoio

Recomendamos atualizar para a versão mais recente do agente assim que estiver disponível. Se você não puder atualizar para a versão mais recente, atualize seu agente para uma versão com no máximo 90 dias. Saiba mais sobre como manter o agente atualizado.

Consulte a New Relic Python política de fim de vida útil do agente para obter informações sobre lançamentos de agentes e datas de suporte.

Notas

Esta versão do agente Python adiciona novas formas de passar erros para notice_error(), adiciona suporte para captura de erros de ferramentas síncronas Strands-Agent, adiciona suporte para gpt-5 e modelos OpenAI LLM mais recentes e corrige uma falha na lógica de utilização do Azure Functions.

Instale o agente usando easy_install/pip/distribute através do Índice de Pacotes Python, usando conda através do Índice de Pacotes Conda-Forge ou baixe-o diretamente do site de download do New Relic.

Recurso

• Adicionar suporte para instâncias de exceção como argumentos para notice_error()

  • notice_error() agora pode aceitar uma instância de exceção capturada (como uma de um bloco try/except) para o argumento error, em vez de uma tupla de exceção de sys.exc_info().

  • Isso é adicional e não substitui o comportamento existente. O uso anterior de notice_error() com zero argumentos ou com uma tupla de exceção ainda deve funcionar corretamente.

• Adicionar suporte para gpt-5 e modelos OpenAI LLM mais recentes

  • Adicionar atualizações à instrumentação OpenAI para suportar nomes de atributos mais recentes usados com modelos OpenAI posteriores

• Adicionar suporte para captura de erros de ferramentas síncronas Strands-Agent

  • Funções Python síncronas usadas como ferramentas em Strands-Agents agora têm captura de erros adequada e capturam rastreamentos em ferramentas como pesquisas de banco de dados.

Correções de bugs

• Proteção contra falhas na utilização do Azure Functions

  • Anteriormente, alguns usuários enfrentavam casos extremos em que a detecção de utilização do Azure Functions travava ao tentar corresponder expressões regulares. A falha foi corrigida e não deverá mais ser possível no futuro.

Declaração de apoio

Recomendamos atualizar para a versão mais recente do agente assim que estiver disponível. Se você não puder atualizar para a versão mais recente, atualize seu agente para uma versão com no máximo 90 dias. Saiba mais sobre como manter o agente atualizado.

Consulte a New Relic Python política de fim de vida útil do agente para obter informações sobre lançamentos de agentes e datas de suporte.

Notas

Esta versão do agente Python adiciona suporte para o seguinte:

• Fios
• AWS Bedrock Converse Streaming
• Métodos Redis hybrid_search e msetex
• Atribuição de funções LangChain para o evento LLM
• timestamp do evento LLM capturado no momento da solicitação do LLM.
• loop_factory parâmetro em asyncio.Runner

Esta versão também corrige um bug na instrumentação ASGI, onde os cabeçalhos não são relatados pelo servidor web.

Instale o agente usando easy_install/pip/distribute através do Índice de Pacotes Python, usando conda através do Índice de Pacotes Conda-Forge ou baixe-o diretamente do site de download do New Relic.

Recurso

• Adicionar suporte para Strands

  • Adicionar instrumentação para as ferramentas Strands e para o agente em configurações de agente único e multiagente (enxames, grafos, etc.).

• Adicionar suporte para AWS Bedrock Converse Streaming

  • Adicionar suporte para monitoramento da API de streaming da Converse. Isso inclui suporte para chamadas de conclusão de bate-papo Converse feitas com clientes boto3 e aioboto3 usando converse_stream().

• Adicionar suporte para métodos Redis

  • Adicionar suporte para os seguintes métodos:

    • hybrid_search
    • msetex

• Adicionar suporte para loop_factory em asyncio.Runner

  • No Python 3.11, a classe asyncio.Runner foi adicionada, assim como o parâmetro loop_factory. O parâmetro loop_factory fornece uma substituição para políticas de loop. Agora, o loop criado é instrumentado, independentemente de ser por meio de uma configuração de loop de eventos global ou de um loop de eventos personalizado.

• Capturar atribuições de funções do LangChain no evento LLM

  • O evento LangChain LlmChatCompletionMessage agora contém a função atribuída do LangChain.

• Registre timestamp do evento LLM no momento da solicitação do LLM.

  • Anteriormente, o timestamp do evento LLM era capturado no momento da criação do evento. Agora, essa informação é capturada com mais precisão no momento da solicitação do LLM.

Correções de bugs

• consumo de cabeçalho ASGI

  • Quando um ASGIWebTransaction consome os cabeçalhos de um evento http.response.start, ele o faz sem levar em consideração os tipos de entrada permitidos. Quando os cabeçalhos são um gerador, o gerador foi consumido pela chamada para process_response() não deixando cabeçalhos restantes para o servidor web enviar. O problema já foi resolvido.

Declaração de apoio

Recomendamos atualizar para a versão mais recente do agente assim que estiver disponível. Se você não puder atualizar para a versão mais recente, atualize seu agente para uma versão com no máximo 90 dias. Saiba mais sobre como manter o agente atualizado.

Consulte a New Relic Python política de fim de vida útil do agente para obter informações sobre lançamentos de agentes e datas de suporte.