Convo: Ferramentas de registro e depuração para a criação de agentes de IA inteligentes

O Convo é uma plataforma de ferramentas voltada para o desenvolvimento de agentes de IA que ajuda os desenvolvedores a criar, depurar e otimizar rapidamente os agentes de IA com base no LangGraph de agentes inteligentes. Ele fornece recursos de registro, gerenciamento de estado e memória multiusuário por meio de integração simples de código, reduzindo a carga sobre os desenvolvedores para configuração de banco de dados e gerenciamento de infraestrutura. O objetivo principal do Convo é permitir que os agentes de IA funcionem imediatamente em ambientes de produção, com suporte para armazenamento de dados do usuário entre sessões, rastreamento de mensagens e invocações de ferramentas e recuperação rápida do estado operacional. A plataforma foi projetada para ser simples e adequada para equipes que precisam desenvolver com eficiência aplicativos de IA confiáveis.

Lista de funções

• Registro: cada mensagem, chamada de ferramenta e saída LLM é capturada automaticamente para que os desenvolvedores possam analisar e depurar.
• Memória de longo prazo: armazenamento entre sessões de fatos, preferências e metas do usuário para dar suporte a interações personalizadas.
• Suporte a vários usuários: gerencie automaticamente os dados de diálogo para vários usuários sem configuração adicional.
• Recuperação de status: a função de ponto de verificação integrada permite que você volte e recupere o status de execução do agente a qualquer momento.
• Não é necessário banco de dados: fornece soluções de código prontas para uso, eliminando configurações complexas.
• Integração de ferramentas: suporte à conexão perfeita com CRM, plataforma de marketing por e-mail e outras ferramentas comumente usadas.
• Suporte à depuração: localize e resolva rapidamente os problemas do agente de IA com registro detalhado e gerenciamento de status.

Usando a Ajuda

O Convo é uma plataforma de ferramentas para que os desenvolvedores se integrem aos projetos de agentes de IA baseados em LangGraph, principalmente por meio do SDK. Abaixo está um guia detalhado para ajudar os usuários a começar rapidamente e aproveitar ao máximo seus recursos.

Processo de instalação

O Convo é muito fácil de instalar, os desenvolvedores só precisam integrá-lo aos seus projetos por meio do SDK fornecido oficialmente, sem configuração adicional de bancos de dados ou infraestrutura complexa. Veja a seguir as etapas:

1. Obtendo o SDKVisite o site da Convo (https://convo.diy/) e faça o download dos pacotes SDK mais recentes na área de documentação do desenvolvedor. A documentação detalhada da API e o código de amostra são fornecidos.
2. Integração de projetos::
   • Em seu projeto LangGraph, adicione uma dependência do Convo SDK. Por exemplo, em um projeto Python, você pode adicionar uma dependência do Convo SDK por meio do parâmetro pip install convo Instalação (comandos específicos são baseados na documentação do site oficial).
   • Importe o módulo Convo em seu código, por exemplo:

     from convo import ConvoAgent
     

   • Inicialize o agente Convo, passando os parâmetros de configuração necessários (por exemplo, chave de API, que pode ser obtida após o registro no site oficial).
3. Ambiente de configuraçãoO Convo elimina a necessidade de configurar manualmente o banco de dados, pois lida automaticamente com o armazenamento de dados e o gerenciamento de estado. Tudo o que os desenvolvedores precisam fazer é verificar se a conexão de rede está funcionando e se a chave da API está configurada corretamente.
4. integração de testesO Convo fornece casos de teste para ajudar os desenvolvedores a confirmar rapidamente a funcionalidade.

Depois de instalado, os desenvolvedores podem usar os recursos do Convo em seus projetos. O processo inteiro geralmente leva apenas alguns minutos, o que o torna adequado para cenários de desenvolvimento rápido e iterativo.

Função Fluxo de operação

Abaixo estão guias detalhados de como fazer para os principais recursos do Convo para ajudar os usuários a começar rapidamente.

1. registro em log

O Convo captura automaticamente todas as mensagens, chamadas de ferramentas e saídas de LLM do agente de IA, eliminando a necessidade de os desenvolvedores as registrarem manualmente. Etapas operacionais:

• Ativar registro em logAo inicializar o agente Convo, defina a opção logging_enabled=True. Exemplo:

  agent = ConvoAgent(api_key="your_api_key", logging_enabled=True)
  

• Ver registroRegistros detalhados: Os registros detalhados são visualizados por meio de um painel fornecido pelo Convo (acessível no site oficial após o login). O painel exibe registros de data e hora, conteúdo da mensagem, detalhes da chamada da ferramenta e saída LLM.
• Exportação de registrosSuporte para exportação de logs para o formato JSON ou CSV para análise posterior. Por exemplo, clique no botão "Exportar" no painel, selecione o formato e faça o download.

2. memória de longo prazo

O Convo suporta o armazenamento de dados do usuário em todas as sessões, garantindo que os agentes de IA se lembrem das preferências do usuário e das interações históricas. Etapas operacionais:

• Dados armazenadosChamada de métodos armazenados no código, por exemplo:

  agent.store_memory(user_id="user123", key="preference", value="likes_dark_mode")
  

• recuperarRecupera uma memória por ID de usuário, por exemplo:

  preference = agent.get_memory(user_id="user123", key="preference")
  

• cenário do aplicativoPode ser usado para recomendações personalizadas. Por exemplo, o agente de IA ajusta o tema da interface ou o conteúdo recomendado com base nas preferências do usuário.
• Gerenciando a memóriaVisualização e edição de dados de memória para todos os usuários no painel, com suporte para operações em lote.

3. suporte a vários usuários

O Convo gerencia automaticamente as conversas com vários usuários, eliminando a necessidade de os desenvolvedores as configurarem manualmente. Etapas operacionais:

• Atribuição de IDs de usuárioAtribua uma ID exclusiva ao usuário em cada interação, por exemplo:

  agent.handle_conversation(user_id="user123", message="Hello")
  

• Exibir dados do usuárioFiltre os registros de diálogo por ID de usuário no painel para visualizar o histórico das interações de um usuário específico.
• PrivacidadeConvo garante que os dados do usuário sejam segregados para impedir o acesso cruzado.

4. recuperação de status

O recurso de ponto de verificação do Convo permite que os desenvolvedores voltem e restaurem o estado operacional do agente de IA, adequado para depurar fluxos de trabalho complexos. Etapas operacionais:

• estado salvoSalvamento de pontos de verificação em nós-chave, por exemplo:

  agent.save_checkpoint(run_id="run456")
  

• estado restauradoRestaurar o estado executando a ID, por exemplo:

  agent.restore_checkpoint(run_id="run456")
  

• comissionamentoExibir o histórico de pontos de controle no painel, selecionar o nó para o qual deseja voltar e clicar no botão "Restore" (Restaurar).

5. integração de ferramentas

O Convo oferece suporte à conectividade com ferramentas externas, como CRM ou plataformas de e-mail. Procedimento operacional:

• Configuração de conexõesAdicionar a chave de API da ferramenta, como a do Salesforce ou do Mailchimp, ao painel.
• ferramenta de invocaçãoAcionamento de operações externas no código por meio da interface de chamada de ferramenta do Convo, por exemplo:

  agent.call_tool("send_email", recipient="user@example.com", content="Hello")
  

• Resultados da verificaçãoVerifique o registro de chamadas da ferramenta no painel para confirmar que a operação foi bem-sucedida.

6. suporte ao comissionamento

O Convo oferece registro detalhado e gerenciamento de status para ajudar os desenvolvedores a identificar rapidamente os problemas. Passo a passo:

• Visualização de errosFiltre a guia "Errors" (Erros) no painel para ver mensagens de erro detalhadas e rastreamentos de pilha.
• reproduzir o problemaUse o recurso de recuperação de estado para voltar ao ponto de verificação antes da ocorrência do problema para reproduzir e corrigir o bug.
• Recomendações de otimizaçãoO painel fornece recomendações de otimização de desempenho com base na análise de registros, como a redução do número de chamadas ao LLM.

advertência

• requisito de rede: Os painéis e as chamadas de API do Convo exigem uma conexão de rede estável.
• referência de documentaçãoRecomendamos que você consulte a documentação oficial com frequência para obter as atualizações mais recentes da API e as práticas recomendadas.
• gerenciamento de direitosChave de API: garanta que a chave de API esteja protegida contra divulgação.

Seguindo essas etapas, os desenvolvedores podem integrar e usar rapidamente os recursos do Convo para aumentar drasticamente a eficiência do desenvolvimento de agentes de IA.

cenário do aplicativo

1. Desenvolvimento de atendimento ao cliente com IA
   O recurso de memória de longo prazo do Convo registra as preferências de compra do usuário, o recurso de registro acompanha os problemas durante as conversas e o recurso de recuperação de estado ajuda a depurar processos complexos de diálogo em várias etapas.
2. Assistente de educação personalizada
   Em aplicativos educacionais, o Convo armazena o progresso e as preferências dos alunos, e o agente de IA fornece sugestões de aprendizado personalizadas com base na memória. O suporte a vários usuários garante que os registros de diferentes alunos não interfiram uns nos outros.
3. Fluxo de trabalho automatizado da empresa
   As organizações usam as ferramentas integradas de CRM e e-mail do Convo para automatizar o tratamento das consultas dos clientes. Os desenvolvedores otimizam rapidamente os fluxos de trabalho e reduzem a intervenção manual por meio de recursos de registro e pontos de verificação.

QA

1. O Convo precisa configurar o próprio banco de dados?
   Não. O Convo fornece uma solução pronta para uso que gerencia automaticamente o armazenamento de dados e os desenvolvedores simplesmente integram o SDK.
2. Como posso visualizar os registros de tempo de execução do agente de IA?
   Faça login no painel do Convo no site do Convo, selecione a guia "Logs" e filtre por um usuário ou período de tempo específico para visualizar os registros detalhados.
3. Quais ferramentas externas são compatíveis com o Convo?
   Suporte para CRM, plataformas de marketing por e-mail e muitas outras ferramentas, cuja lista pode ser visualizada na documentação do site oficial. A integração é feita por meio de chaves de API.
4. Como faço para restaurar o status operacional do agente?
   Use o restore_checkpoint ou selecione o ponto de verificação no painel e clique no botão Recuperar.