Data Transmission Service:Tutorial: Usar uma base de conhecimento do DTS RAGFlow como base de conhecimento externa no Dify

Etapa 1: Criar uma base de conhecimento e fazer upload de arquivos

1. Faça logon na página do RAGFlow.

2. Crie uma base de conhecimento.

   1. No canto superior direito da página, clique em Create Knowledge Base.

   2. Na caixa de diálogo Create Knowledge Base, insira um Name para a base de conhecimento.

   3. Clique em OK.

   4. Configure a base de conhecimento e clique em Save.

3. Faça o upload de arquivos para a base de conhecimento.

   1. Na página Dataset da base de conhecimento, selecione New File > Local File.

   2. Na caixa de diálogo File, selecione e faça o upload dos seus arquivos locais.

   3. Marque a caixa de seleção Parse When Creating.

   4. Clique em OK.

Etapa 2: Adicionar e conectar a base de conhecimento externa

1. Acesse a página Knowledge Base no DMS.

   Nota

   Para obter instruções sobre como acessar esta página, entre em contato com o suporte técnico do DMS.

   Na página Knowledge Base, clique no link Connect to External Knowledge Base → na parte inferior do cartão + Create Knowledge Base.

2. Adicione uma API de base de conhecimento externa.

   1. No lado direito da página, clique em External Knowledge Base API.

   2. Clique em Add External Knowledge Base API.

   3. Configure as informações da API da base de conhecimento externa.

      Parameter	Description
      Name	Insira um nome descritivo para facilitar a identificação.
      API endpoint	O endpoint da API da base de conhecimento do DTS RAGFlow, no formato http://<IP>/api/v1/dify. Nota Substitua <IP> pelo endereço de conexão da base de conhecimento do DTS RAGFlow. Se você usar o Knowledge Base Intranet Address, adicione o bloco CIDR IPv4 do vSwitch onde o DMS Dify está localizado à lista de permissões de IP da base de conhecimento do DTS RAGFlow. Se usar o Knowledge Base External Network Address, adicione também o endereço IP de saída pública do DMS Dify à lista de permissões de IP da base de conhecimento do DTS RAGFlow.
      API key	A chave da API para a base de conhecimento do RAGFlow. Nota Para obter a chave, consulte Obter a chave da API para a base de conhecimento do RAGFlow.

   4. Clique em Save.

3. Conecte a base de conhecimento externa.

   1. No painel External Knowledge Base API no lado direito da página, clique no ícone de atualização .

   2. No cartão Create Knowledge Base, clique em Connect External Knowledge Base.

   3. Configure as informações da base de conhecimento externa.

      Parameter	Description
      External knowledge base name	Insira um nome descritivo para a base de conhecimento externa.
      Knowledge Base Description (Optional)	Insira uma descrição para a base de conhecimento externa.
      External knowledge base API	Selecione a API da base de conhecimento externa adicionada na Etapa 2.
      External knowledge base ID	Insira o ID da base de conhecimento externa. Nota Para obter o ID, consulte Obter o ID da base de conhecimento do RAGFlow.
      Retrieval settings	Defina os valores de Top K e score threshold.

   4. Clique em Connect.

      Um cartão com o nome inserido no campo External knowledge base name aparecerá na página Knowledge Base do DMS.

Etapa 3: Criar workflows e aplicações

No console do DMS, use essa base de conhecimento para desenvolver aplicações LLM.

Obter o endereço de conexão

1. Acesse a página da lista de bases de conhecimento do RAGFlow na região de destino.

   1. Faça logon no console do Data Transmission Service (DTS).

   2. No painel de navegação à esquerda, clique em Data Preparation.

   3. No canto superior esquerdo, selecione a região onde a instância de preparação de dados está localizada.

   4. Clique na aba RAGFlow knowledge base.

2. Na coluna Actions da base de conhecimento do RAGFlow desejada, clique em Manage.

3. Na seção Endpoint, copie o Knowledge Base Intranet Address ou o Knowledge Base External Network Address.

Obter a chave da API

1. Faça logon na página do RAGFlow.

2. No painel de navegação à esquerda, clique em API.

3. À direita de RAGFlow API, clique em API KEY.

4. Na caixa de diálogo API KEY, clique em Create New Key.

5. Clique em para copiar a chave e salve-a em um local seguro.

Obter o ID da base de conhecimento

1. Faça logon na página do RAGFlow.

2. Na página Knowledge Base, clique na base de conhecimento desejada.

3. Na URL da barra de endereços do navegador, copie o ID da base de conhecimento.

   Nota

   O ID da base de conhecimento é a sequência de caracteres após id=.

Criar e usar uma aplicação Chat Assistant

1. Crie uma aplicação Chat Assistant.

   1. Na página Knowledge Base do DMS, clique na aba Studio.

   2. Clique em Chat Assistant.

   3. No cartão Create Application, clique em Create Blank Application.

   4. Configure as informações da aplicação.

      Parameter	Description
      Select application type	Selecione Chat Assistant.
      Application name & icon	Insira um nome e escolha um ícone para a aplicação Chat Assistant.
      Description (Optional)	Insira uma descrição para a aplicação Chat Assistant.

   5. Clique em Create.

3. Clique na aplicação Chat Assistant criada.

4. Orquestre a aplicação Chat Assistant.

   1. Insira um prompt.

   2. Na seção Knowledge Base, clique em Add.

   3. Selecione a base de conhecimento externa configurada na Etapa 2 e clique em Add.

   4. Configure as Retrieval settings conforme necessário e clique em Save.

   5. No canto superior direito da página, selecione o modelo para a aplicação Chat Assistant.

5. Na caixa de texto Chat with bot, insira uma pergunta para testar a aplicação.