Der vollständige Leitfaden für Dify-Anpassungstools von der Erstellung bis zur Bereitstellung

Erweiterung der KI-Fähigkeiten: Ein kompletter Leitfaden für die Erstellung und den Einsatz von Dify-Anpassungstools

Große Sprachmodelle sind für sich genommen schon sehr leistungsfähig, aber ihre Kraft kommt erst richtig zur Geltung, wenn sie mit Daten und Diensten aus der realen Welt verbunden werden. Ganz gleich, ob es sich um die Abfrage der neuesten Logistikinformationen, den Zugriff auf die interne Wissensdatenbank eines Unternehmens oder den Aufruf einer bestimmten Datenanalyseschnittstelle handelt - diese Konnektivität ist der Schlüssel zum Aufbau praktischer KI-Anwendungen. Und genau das ist es, was Dify Der Wert der "Custom Tools"-Funktion in der Plattform - sie bietet einen klaren Weg für Entwickler, alle externen Tools einzubinden API Nahtlose Integration, die KI in die Lage versetzt, bereichsspezifische Probleme zu lösen.

Als Nächstes werden wir Schritt für Schritt aufschlüsseln, wie die Dify Erstellen Sie ein benutzerdefiniertes Tool und nehmen Sie es in Betrieb in

Schritt 1: Definieren Sie den Blueprint - Schreiben Sie die Beschreibung der API-Schnittstelle

lassen Sie Dify Das Verständnis Ihres Werkzeugs beginnt mit der Erstellung einer "Bedienungsanleitung", d. h. API Beschreibung der Schnittstelle. Diese Beschreibungsdatei teilt der Plattform mit, was Ihr Werkzeug kann, wie es aufgerufen wird und welche Parameter erforderlich sind.

Derzeit.Dify Unterstützt zwei der führenden Unternehmen der Branche API Beschreiben Sie die Spezifikation:

• OpenAPI (Swagger). Eine weit verbreitete API Beschreibung der Sprache, die die moderne Welt ist RESTful API Die faktischen Standards der
• ChatGPT-Plugin. nachkommen OpenAI Spezifikation für sein Plugin-Ökosystem.

Sie können direkt die JSON vielleicht YAML Formatbeschreibungsinhalt in das Eingabefeld einfügen, oder Sie können eine URL Adresse.Dify werden automatisch abgerufen und geparst.

Schritt 2: Import und Validierung

Nach dem Importieren der Beschreibungsdatei wird dieDify analysiert automatisch den Inhalt und identifiziert alle Werkzeuge, die in der Datei API Endpunkte. Die Plattform listet die Pfade für jede Schnittstelle übersichtlich auf (z. B. /weather), Methodik der Anfrage (GET / POST) und die erforderlichen Eingabeparameter (wie z. B. city).

Dies ist ein wichtiger Bestandteil der Validierung. Sie können ein anerkanntes Tool direkt auf der Schnittstelle testen, Parameter eingeben und die zurückgegebenen Ergebnisse sehen, um sicherzustellen, dass es funktioniert, bevor es in eine KI-Anwendung integriert wird.

Schritt 3: Konfigurieren der Zugriffskontrolle - Festlegen der Authentifizierungsmethode

Nachdem Sie das Tool definiert haben, müssen Sie entscheiden, wer es benutzen darf. Dies geschieht durch die Konfiguration der Authentifizierung, die dem Einrichten Ihrer API Der Dienst ist nicht zugänglich.

Dify Es werden hauptsächlich zwei Arten der Authentifizierung angeboten:

• Keine Genehmigung. Öffentlich zugänglich, d. h. jeder oder jede Anwendung kann das Tool direkt und ohne Anmeldedaten aufrufen. Ideal für öffentliche, kostenlose Dienste.
• API-Schlüssel-Authentifizierung. Der Aufrufer muss in der Anfrage einen vordefinierten Schlüssel angeben (API Key). Dies dient dem Schutz privater oder bezahlter API Standardverfahren, um sicherzustellen, dass nur befugte Benutzer Zugang haben.

Ein Wetter-Checker beispielsweise funktioniert für alle, wenn Sie "Keine Authentifizierung" wählen; wenn Sie "Keine Authentifizierung" wählen, funktioniert er für alle.API Key", müsste der Benutzer den Schlüssel erhalten, bevor er das Wetter überprüfen kann.

Schritt 4: Inbetriebnahme des Dienstes - Inbetriebnahme des Tools in der Cloud

existieren Dify Wenn die Plattform wie oben beschrieben konfiguriert ist, wird das Tool nur "registriert". Damit die KI es tatsächlich aufrufen kann, muss das Werkzeug hinter der API Der Dienst muss im Internet bereitgestellt werden und über eine öffentlich zugängliche URL.

Es gibt zwei Hauptoptionen für den Einsatz, die sich jeweils an Benutzer mit unterschiedlichem technischem Hintergrund richten.

Option 1: Schneller Weg zu Null Servern - dify-tools-worker

Für Entwickler, die keine Server verwalten wollen oder mit der Backend-Entwicklung nicht vertraut sind, bietet dasDify Offiziell gibt es eine Datei namens dify-tools-worker Das Open-Source-Projekt.

Sie basiert auf Cloudflare Workers Plattform, einer leistungsstarken Serverless-Computing-Umgebung, mit der Sie Code ausführen können, ohne einen Server kaufen und konfigurieren zu müssen.

Vorteile der Nutzung dieses Programms:

• Erzeugt automatisch eine Datei, die den OpenAPI Spezifikation der Schnittstellendokumentation.
• Schnelle Bereitstellung zu sehr geringen Kosten (Cloudflare Workers (Bereitstellung von kostenlosen Credits).
• Sie erhalten eine Online-Dienstadresse und eine Dokumentenadresse, z. B. https://difytoolsworker.yourname.workers.dev/docLetztere können direkt in der Dify Das Werkzeug wird in das Verzeichnis

Diese Lösung eignet sich hervorragend, um Ideen schnell zu validieren und in Betrieb zu nehmen.

Option 2: Spezialisierte Berufsbildungsabschnitte mit voller Kontrolle - FastAPI

Wenn Sie Python Entwickler oder diejenigen, die die vollständige Kontrolle über den Dienst haben möchten, verwenden die FastAPI Das Framework baut sich selbst auf und stellt sich als professionellere Option zur Verfügung.

FastAPI ist ein modernes, leistungsstarkes Python Web Rahmens ist eines seiner größten Highlights dieAutomatische Erstellung einer interaktiven API-Dokumentation.

Es hat einen einfachen Arbeitsablauf:

1. Kosten oder Aufwand Python Schreiben Sie Ihr API Logik.
2. FastAPI wird automatisch erstellt, wenn Sie den Dienst ausführen OpenAPI Kompatible Dokumente.

Ein einfaches FastAPI-Beispiel:

from fastapi import FastAPI
app = FastAPI()
@app.get("/hello")
def say_hello(name: str):
return {"message": f"Hello, {name}!"}

Nachdem Sie diesen Dienst gestartet haben, können Sie die automatisch erstellte Dokumentation unter folgender Adresse abrufen:

• http://localhost:8000/docs: Swagger UI Interaktive Dokumentation in einem Format, das direkt getestet werden kann.
• http://localhost:8000/openapi.json: Original OpenAPI JSON Beschreiben Sie die Datei.

Alles, was Sie tun müssen, ist diese FastAPI Die Anwendung wird auf einem beliebigen Cloud-Server oder einer PaaS-Plattform bereitgestellt, und dann wird die online generierte /openapi.json Die Adresse wird mitgeteilt an DifyDas Importieren von Werkzeugen ist im Handumdrehen erledigt. Diese Lösung bietet Ihnen ein Höchstmaß an Flexibilität und Skalierbarkeit.