Coleta de dados de diagnóstico para problemas de desempenho

1. Detalhes do locatário e do ambiente

Comece compartilhando informações básicas sobre o ambiente. Ele ajuda o suporte do IBM a identificar sua implementação e região, o que é essencial para identificar problemas relacionados à infraestrutura.

Compartilhe os seguintes detalhes:

• ID do inquilino ou CRN: Inclua o CRN do seu inquilino. Você pode encontrá-lo clicando em seu perfil > Sobre. Anexe uma captura de tela da página Sobre.

• Plataforma: Especifique se seu ambiente é executado em AWS ou IBM Cloud.

• Região: você pode encontrá-la clicando em seu perfil > Região.

Os detalhes do locatário e da região permitem que o suporte do IBM verifique se há fatores de desempenho específicos da plataforma ou da região.

2. Detalhes do modelo de IA

Forneça o nome do modelo de IA usado no agente afetado. Isso é fundamental porque diferentes modelos têm arquiteturas, recursos e limitações conhecidas exclusivas.

Siga estas etapas para encontrar os detalhes do modelo de IA:

1. No menu principal, vá para Build.

2. Vá para All agents (Todos os agentes ) e selecione o agente afetado.

3. Na página de configuração do agente, copie e salve os detalhes do modelo de IA da lista Modelos de IA.

Por exemplo,

llama-3-2-90b-vision-instruct

O conhecimento do modelo exato ajuda o suporte do IBM a diagnosticar problemas de desempenho específicos do modelo e a aplicar correções direcionadas.

3. Configuração do perfil do agente

A configuração do agente determina como o agente interpreta as consultas e responde. Configurações incorretas podem levar a um comportamento ou latência inesperados.

Veja a seguir as etapas para encontrar os detalhes:

1. No menu principal, vá para Build.

2. Vá para All agents (Todos os agentes ) e selecione o agente afetado.

3. Na página de configuração do agente, vá para Conhecimento.

4. Confirme o estilo do agente (Padrão ou ReAct ).

5. Confirme se a modalidade de voz está ativada e identifique os modelos STT e TTS em uso.

4. Detalhes da configuração do conhecimento

As fontes de conhecimento afetam a forma como os agentes recuperam e processam os dados. Veja a seguir as etapas para encontrar os detalhes da configuração do conhecimento:

1. No menu principal, vá para Build.

2. Vá para All agents (Todos os agentes ) e selecione o agente afetado.

3. Na página de configuração do agente, vá para Conhecimento.

4. Observe os seguintes detalhes em Fonte de conhecimento.

   • Fontes de conhecimento: Milvus, Elasticsearch, Serviço personalizado, Astra DB.

   • Upload de arquivos (se aplicável):

     • Tipos de documento:.docx,.pdf,.pptx,.xlsx,.csv,.html,.txt.

     • Tamanho do documento.

5. Ferramentas e agentes colaboradores

As ferramentas e os agentes colaboradores desempenham um papel importante no desempenho de seu agente. Cada ferramenta acrescenta etapas de processamento, e as integrações podem introduzir latência ou erros. O fornecimento desses detalhes ajuda o IBM Support a entender a complexidade de seu agente e a identificar possíveis gargalos.

Veja a seguir as etapas para encontrar as ferramentas e os detalhes do agente colaborador:

1. No menu principal, vá para Build.

2. Vá para All agents (Todos os agentes ) e selecione o agente afetado.

3. Na página de configuração do agente, vá para Toolset.

4. Observe os detalhes em Tools (Ferramentas ). O número de ferramentas utilizadas e o tipo de ferramenta utilizada ( OpenAPI,Python, MCP Server, Flow, Langflow).

5. Anote os detalhes dos agentes, tais como agentes de catálogo, agentes externos, assistente d watsonx Orchestrate ou {{ site.data.keyword externo. conversas curtas}}.

6. Canais e configurações personalizadas

Liste todos os canais e configurações personalizadas, tais como: Agente incorporado, Microsoft Teams, Facebook Messenger e assim por diante. Veja a seguir as etapas para encontrar os detalhes dos canais:

1. No menu principal, vá para Build.

2. Vá para All agents (Todos os agentes ) e selecione o agente afetado.

3. Na página de configuração do agente, vá para Channels (Canais ).

4. Observe os canais habilitados.

7. Documentar mudanças e eventos recentes

Os problemas de desempenho geralmente ocorrem após as mudanças. Analise e registre os seguintes detalhes:

• Alterações recentes nos agentes (ferramentas, configurações)

• Fatores ambientais na época em que o problema começou

8. Coletar e exportar dados de rastreamento

Os rastros são essenciais para diagnosticar problemas de desempenho. Veja a seguir as etapas para coletar os dados de rastreamento:

1. No menu principal, vá para Analisar e selecione o agente.

2. Clique no status de uma mensagem na tabela _Traces_ para visualizar todos os detalhes do rastreamento.

3. Clique em Nova Janela para abrir o rastreamento na interface do usuário d Jaeger.

4. Em Jaeger, selecione Trace Timeline > Trace JSON para visualizar o rastreamento no formato JSON.

5. Para salvar o rastreamento:

   • Clique com o botão direito do mouse e selecione _Salvar como…_

   • Nomeie o arquivo e salve-o para referência.

Consulte a página de análises do agente de monitoramento para obter mais detalhes.

9. Opcional: Detalhes do agente de exportação

A exportação de detalhes do agente fornece ao suporte do IBM um instantâneo completo da configuração e da instalação do agente.

Você pode exportar a configuração do seu agente usando o watsonx Orchestrate Kit de Desenvolvimento de Agentes.

Execute o seguinte comando para exportar os detalhes do agente:

orchestrate agents export -n <agent_name> -k native -o <agent_name>.zip