Dify Tutorial: Aufbau eines privaten vernetzten Suchwerkzeugs zum Nulltarif mit Tencent MetaWare

Bei der Entwicklung fortschrittlicher KI-Anwendungen ist die vernetzte Echtzeitsuche eine wichtige Funktion zur Synchronisierung von Informationen. Bei der direkten Verwendung des offiziellen Such-Plugins der Plattform kann es jedoch zu Netzwerkbeschränkungen oder hohen API-Gebühren kommen.

Dieses Papier bietet eine kosteneffiziente Alternative: durch die Dify HTTP-Anfragefunktionalität in Kombination mit der Tencent MetaWare-Plattform, um ein privates, kostenloses, vernetztes Suchwerkzeug zu erstellen. Dieser Ansatz umgeht nicht nur die Beschränkungen von Abhängigkeiten, sondern ermöglicht es auch Agent Starker Zugang zu Echtzeit-Informationen.Dify ist eine Open-Source-Plattform für LLMOps, die Entwicklern helfen soll, KI-Anwendungen auf der Grundlage großer Sprachmodelle schnell zu erstellen und zu betreiben.

Analyse der Architektur

Das Prinzip dieses Systems kann als "Dienstleistungsmakler" verstanden werden.

Wir nutzen Tencent MetaWare als Anbieter von externen Suchdiensten. Tencent MetaWare ist eine KI-Anwendungsentwicklungsplattform, die durch ihre Workflow-Funktion komplexe Suchlogik in eine Standard-API-Schnittstelle kapseln kann.

danach Dify in dem die Schnittstelle unter Verwendung des HTTP-Anforderungsknotens als Client aufgerufen wird. Veröffentlichen Sie schließlich den gesamten HTTP-Aufrufablauf als Dify Werkzeug, so dass es von jedem Agent oder Workflow modular aufgerufen werden.

Die Vorteile dieser Architektur liegen auf der Hand:

1. entkoppeltImplementierung von Suchdiensten mit Dify Die Anwendungslogik ist getrennt, um unabhängige Wartung und Upgrades zu ermöglichen.
2. KostenkontrolleNutzen Sie die Ressourcen einer kostenlosen Plattform, um API-Kosten zu vermeiden.
3. PrivatisierungDie Werkzeuge werden von Ihnen selbst gebaut und kontrolliert, mit klaren Datenverbindungen und höherer Sicherheit.

Was muss ich vorbereiten?

Bevor Sie beginnen, bereiten Sie bitte die folgende Umgebung und die Anmeldedaten vor:

1. Tencent MetaWare Plattform ZugangRegistrierung und Anmeldung unter https://yuanqi.tencent.com/.
2. Dify BetriebsumgebungEntweder die Community Edition oder die Cloud Service Edition ist verfügbar.
3. Großes Modell API-Schlüssel (optional)Die Arbeitsabläufe von Tencent MetaWare verwenden standardmäßig das eingebaute Modell, aber einige erweiterte Funktionen oder benutzerdefinierte Konfigurationen können es erforderlich machen, dass der Benutzer seinen eigenen Modell-API-Schlüssel angibt (z. B. den DeepSeek usw.). Sie werden in diesem grundlegenden Suchlehrgang nicht behandelt und können vorerst unvorbereitet bleiben.

Operative Schritte: von der Serviceerstellung bis zur Toolintegration

Befolgen Sie die nachstehenden Schritte, um den gesamten Bauprozess schrittweise abzuschließen.

Phase 1: Aufbau und Veröffentlichung von Suchdiensten in Tencent MetaWare

1. Arbeitsabläufe erstellen
   Melden Sie sich bei Tencent MetaWare an, erstellen Sie eine neue Intelligence und wählen Sie "Workflow" als Erstellungsmodus.
   
2. Such-Plugin hinzufügen
   Suchen Sie im Workflow Canvas das offizielle Plugin "Search" und fügen Sie es aus der Plugin-Bibliothek auf der linken Seite hinzu.
   
   
3. Konfigurationsparameter
   Konfigurieren Sie die Eingabeparameter des Plugins, um sicherzustellen, dass es eingehende externe Abfragevariablen (Query) erhält.
   
4. Test und Freigabe
   Führen Sie einen Testlauf in der Workflow-Schnittstelle durch, um zu prüfen, ob die Suchfunktion korrekt funktioniert. Nachdem Sie überprüft haben, dass keine Fehler vorliegen, veröffentlichen Sie den Workflow, verknüpfen ihn mit dem Smart Body und veröffentlichen schließlich den Smart Body.
   
5. API-Anmeldeinformationen abrufen
   Rufen Sie die Verwaltungsseite der intelligenten Stelle auf, suchen Sie den Abschnitt "Schnittstellenaufruf" unter "Veröffentlichungsinformationen" und rufen Sie die URL der API ab,Authorization und die für die Unterzeichnung erforderlichen Header-Informationen. Dies sind die Informationen, die für die Verbindung der Dify mit dem Schlüssel zu den Meta-Artefakten.
   

Stufe 2: Erstellen und Einbinden von HTTP-Tools in Dify

1. Initialisierung eines Workflows
   existieren Dify um eine Datei zu erstellen, die die Start -> HTTP-Anfrage -> Ende den Arbeitsablauf des Knotens.
   
2. Konfigurieren des HTTP-Anfrageknotens
   Dies ist der zentrale Aspekt der Integration.
   • Methode: POST
   • URL anfordernGeben Sie die API-URL ein, die Sie von Tencent MetaTool erhalten haben.
   • KopfzeilenAuthentifizierung: Genaues Ausfüllen aller aus dem Metaverse bezogenen Authentifizierungs-Header, wie z. B. Authorization, X-TC-Timestamp usw.
   • Körper: Wählen raw-textDas Format ist application/jsonund konstruieren Sie den Anfragekörper als {"query": "{{query}}"}. Hier. {{query}} sein Dify Die variablen Platzhalter für die
     
3. Einheitstest
   Verwenden Sie innerhalb des HTTP-Knotens die Funktion "Diesen Schritt ausführen", um eine Testabfrage einzugeben und zu überprüfen, ob die Schnittstelle Folgendes zurückgibt status 200 Der Erfolgsstatuscode der
4. Als Werkzeug veröffentlichen
   Nach der Validierung speichern und veröffentlichen Sie den Workflow. Der wichtigste Schritt ist, oben rechts auf "Als Tool veröffentlichen" zu klicken und ihm einen eindeutigen Namen zu geben, z. B. Internal_Search_Engine.
   
   

Stufe 3: Validierung der Tools im Agenten

1. Erstellen eines Testagenten
   Erstellen Sie eine neue Agent Die Anwendung wird für Tests verwendet.
2. Ladewerkzeug
   existieren Agent fügen Sie im Konfigurationspunkt "Tools" die soeben erstellte Internal_Search_Engine Werkzeuge.
3. End-to-End-Tests
   Senden Sie auf dem Bildschirm Debug und Vorschau eine Nachricht an den Agent Stellen Sie eine Frage, die Echtzeitinformationen erfordert. Beobachten Sie, ob es in der Lage ist, das Tool korrekt aufzurufen und eine Antwort anhand der zurückgegebenen Suchergebnisse zu generieren.
   

Fehlersuche und Optimierung

• häufig anzutreffen 400 Bad Request falsch
  Dieses Problem ist in der Regel ein Konstruktionsfehler in der HTTP-Anfrage. Bitte konzentrieren Sie sich darauf, dies zu überprüfen:
  1. Headers ob die eingegebenen Authentifizierungsinformationen vollständig und fehlerfrei sind, insbesondere Authorization und zeitstempelbezogene Felder. Beachten Sie, dass einige Signaturnachweise zeitabhängig sind. Wenn der Aufruf fehlschlägt, können Sie versuchen, sie neu zu generieren.
  2. Body Die JSON-Formatierung in der
  3. Content-Type Steht die Kopfzeile auf application/json.
• Leistungsoptimierung
  Unterstützung des Such-Plugins von Tencent MetaWare limit Parameter, mit dem Sie die Anzahl der zurückgegebenen Ergebnisse steuern können (Standardwert ist 10). Sie können diesen Parameter auch als Variable im Meta-Ware-Workflow festlegen und ihn dann in der Dify Die Informationen werden dynamisch in den HTTP-Anforderungskörper eingefügt, um die Informationsdichte an verschiedene Szenarien anzupassen und die Verarbeitungseffizienz zu optimieren.