Tutorial da Dify: Criando uma ferramenta de pesquisa privada em rede a custo zero com o Tencent MetaWare

Ao criar aplicativos avançados de IA, a pesquisa em rede em tempo real é um recurso essencial para sincronizar informações. No entanto, o uso direto do plug-in de pesquisa oficial da plataforma pode gerar limitações de rede ou altas taxas de API.

Este documento oferece uma alternativa econômica: por meio da Dify combinada com a plataforma MetaWare da Tencent, para criar uma ferramenta de pesquisa privada, gratuita e em rede. Essa abordagem não apenas ignora as restrições de dependência, mas também permite que você Agent Forte acesso a informações em tempo real.Dify é uma plataforma LLMOps de código aberto projetada para ajudar os desenvolvedores a criar e operar rapidamente aplicativos de IA com base em grandes modelos de linguagem.

Análise de arquitetura

O princípio desse esquema pode ser entendido como um "corretor de serviços".

Usamos o Tencent MetaWare como provedor de serviços de pesquisa externa. A Tencent MetaWare é uma plataforma de desenvolvimento de aplicativos de IA que pode encapsular a lógica de pesquisa complexa em uma interface de API padrão por meio de seu recurso de fluxo de trabalho.

posteriormente Dify no qual a interface é invocada usando o nó de solicitação HTTP como cliente. Eventualmente, publique todo o fluxo de chamada HTTP como um Dify para que possa ser usada por qualquer Agent ou fluxo de trabalho invocado de forma modular.

As vantagens da arquitetura são claras:

1. desacopladoImplementação de serviços de pesquisa com Dify A lógica do aplicativo é separada para facilitar a manutenção e as atualizações independentes.
2. controle de custosAproveite os recursos de uma plataforma gratuita para obter custo zero de API.
3. privatizaçãoAs ferramentas são criadas e controladas por você mesmo, com links de dados claros e maior segurança.

O que eu preciso preparar?

Antes de começar, prepare o ambiente e as credenciais a seguir:

1. Acesso à plataforma MetaWare da TencentRegistre-se e faça login em https://yuanqi.tencent.com/.
2. Ambiente operacional da Dify: Está disponível a Community Edition ou a Cloud Service Edition.
3. Chave da API do modelo grande (opcional)Os fluxos de trabalho do Tencent MetaWare usam seu modelo interno por padrão, mas alguns recursos avançados ou configurações personalizadas podem exigir que o usuário forneça sua própria chave de API de modelo (como a chave DeepSeek etc.). Elas não são abordadas neste tutorial de pesquisa básica e podem ser deixadas de lado por enquanto.

Etapas operacionais: da criação do serviço à integração da ferramenta

Siga as etapas abaixo para concluir todo o processo de construção em etapas.

Fase 1: Criar e publicar serviços de pesquisa no Tencent MetaWare

1. Criação de fluxos de trabalho
   Faça login no Tencent MetaWare, crie uma nova inteligência e selecione "Fluxo de trabalho" como modo de criação.
   
2. Adicionar plug-in de pesquisa
   Na tela de fluxo de trabalho, localize e adicione o plug-in oficial "Search" na biblioteca de plug-ins à esquerda.
   
   
3. Parâmetros de configuração
   Configure os parâmetros de entrada do plug-in para garantir que ele receba variáveis de consulta externas de entrada (Query).
   
4. Teste e liberação
   Faça uma execução de teste na interface do fluxo de trabalho para verificar se a função de pesquisa está funcionando corretamente. Depois de confirmar que não há erros, publique o fluxo de trabalho e associe-o ao corpo inteligente e, por fim, publique o corpo inteligente.
   
5. Obtenção de credenciais de API
   Vá para a página de gerenciamento do Intelligent Body, localize a seção "Interface Call" em "Publishing Information" e obtenha o URL da API,Authorization e as informações de Headers necessárias para a assinatura. Essas são as informações necessárias para conectar o Dify com a chave para os meta-artefatos.
   

Etapa 2: Criando e envolvendo ferramentas HTTP na Dify

1. Inicialização de um fluxo de trabalho
   existir Dify em um arquivo, crie um arquivo contendo o Início -> Solicitação HTTP -> Fim fluxo de trabalho do nó.
   
2. Configuração do nó de solicitação HTTP
   Esse é o aspecto central da integração.
   • Método: POST
   • URL de solicitaçãoPreencha o URL da API obtido da Tencent MetaTool.
   • CabeçalhosPreenchimento preciso de todos os cabeçalhos de autenticação obtidos do metaverso, como Authorization, X-TC-Timestamp etc.
   • Corpo: Selecione raw-textO formato é application/jsone construa o corpo da solicitação como {"query": "{{query}}"}. Aqui. {{query}} ser Dify Os espaços reservados para as variáveis
     
3. teste unitário
   No nó HTTP, use a função "Run this step" (Executar esta etapa) para inserir uma consulta de teste e verificar se a interface retorna o seguinte status 200 O código de status de sucesso do
4. Publicar como uma ferramenta
   Depois de validado, salve e publique o fluxo de trabalho. A etapa mais importante é clicar em "Publish as Tool" (Publicar como ferramenta) no canto superior direito e dar a ele um nome claro, por exemplo Internal_Search_Engine.
   
   

Etapa 3: Validação de ferramentas no agente

1. Criação de um agente de teste
   Criar um novo Agent O aplicativo é usado para testes.
2. ferramenta de carregamento
   existir Agent No item de configuração "Tools" (Ferramentas), adicione o arquivo Internal_Search_Engine Ferramentas.
3. Testes de ponta a ponta
   Na tela Debug and Preview, envie uma mensagem para o Agent Faça uma pergunta que exija informações em tempo real. Observe se ele é capaz de chamar a ferramenta corretamente e gerar uma resposta usando os resultados de pesquisa retornados.
   

Solução de problemas e otimização

• comumente visto 400 Bad Request incorreto
  Esse problema geralmente é um erro de construção na solicitação HTTP. Concentre-se em verificar isso:
  1. Headers se as informações de autenticação estão completas e livres de erros, em particular Authorization e campos relacionados ao registro de data e hora. Observe que algumas credenciais de assinatura são sensíveis ao tempo, portanto, se a chamada falhar, você poderá tentar gerá-las novamente.
  2. Body A formatação JSON no
  3. Content-Type O cabeçalho está definido como application/json.
• otimização do desempenho
  Suporte ao plug-in de pesquisa do Tencent MetaWare limit que permite controlar o número de resultados retornados (o padrão é 10). Você também pode definir esse parâmetro como uma variável no fluxo de trabalho de metadados e, em seguida, defini-lo na função Dify As informações são passadas dinamicamente para o corpo da solicitação HTTP para ajustar a densidade das informações de acordo com diferentes cenários e otimizar a eficiência do processamento.