APIMart in Dify verwenden

​

Voraussetzungen

1. Dify-Konto registriert Besuchen Sie die offizielle Dify-Website, um ein Konto zu registrieren, wählen Sie die Cloud- oder Self-hosted-Version
2. APIMart-API-Schlüssel vorhanden Melden Sie sich in der APIMart-Konsole an, um Ihren API-Schlüssel zu erhalten (beginnt mit sk-)

​

Schritt 1: Bei Dify anmelden und Einstellungen aufrufen

​

1.1 Auf die Dify-Plattform zugreifen

• Cloud-Version: Besuchen Sie https://cloud.dify.ai und melden Sie sich an
• Self-hosted-Version: Besuchen Sie Ihre Dify-Bereitstellungsadresse

​

1.2 Zu Modelleinstellungen navigieren

1. Klicken Sie auf das Avatar-Symbol oben rechts
2. Wählen Sie Settings
3. Wählen Sie im linken Menü Model Provider

​

Schritt 2: APIMart-Modellanbieter hinzufügen

​

2.1 Konfigurationsmethode wählen

​

Methode 1: OpenAI Custom API verwenden (empfohlen)

1. Suchen Sie den Anbieter OpenAI auf der Seite Model Provider
2. Klicken Sie auf Configure oder Settings
3. Auf der Konfigurationsseite:
   • API Key: Geben Sie Ihren APIMart-API-Schlüssel ein (sk-xxxxxxxxxxxx)
   • API Base URL oder Base URL: Geben Sie https://api.apimart.ai/v1 ein
4. Klicken Sie auf Save

5. Nach der Konfiguration kehren Sie zur OpenAI-Anbieterseite zurück und sehen die Model List ein
6. Suchen Sie in der Modellliste die benötigten Modelle (z. B. gpt-4o, gpt-4o-mini, chatgpt-4o-latest usw.)
7. Klicken Sie auf den Schalter rechts neben dem Modell, um es zu aktivieren (Blau zeigt aktiviert an)

​

Methode 2: Benutzerdefinierten Modellanbieter hinzufügen

1. Scrollen Sie nach unten zum Abschnitt Custom Model
2. Klicken Sie auf die Schaltfläche + Add Model

​

2.2 APIMart-Anbieter konfigurieren

​

2.3 Weitere Modelle hinzufügen (optional)

1. Im Abschnitt benutzerdefinierter Modelle klicken Sie erneut auf + Add Model
2. Füllen Sie die Konfigurationsinformationen für ein anderes Modell aus
3. Klicken Sie auf Save

​

GPT-4/5-Serie

​

Claude-Serie

​

Gemini-Serie

​

Schritt 3: APIMart-Modelle in Anwendungen nutzen

​

3.1 Neue Anwendung erstellen

1. Kehren Sie zur Dify-Startseite zurück
2. Klicken Sie auf Create App
3. Wählen Sie den Anwendungstyp:
   • Chatbot – Konversationsanwendung
   • Text Generator – Textgenerierungsanwendung
   • Agent – intelligenter Agent
   • Workflow – komplexe Workflow-Anwendung

​

3.2 APIMart-Modell auswählen

1. Suchen Sie den Bereich Model Settings
2. Klicken Sie auf das Dropdown Select Model
3. Wählen Sie den Anbieter APIMart
4. Wählen Sie Ihr konfiguriertes Modell (z. B. gpt-4o)

​

3.3 Modellparameter konfigurieren

​

Schritt 4: Anwendung erstellen und testen

​

4.1 Prompts hinzufügen

1. Schreiben Sie Prompts im Bereich System Prompt
2. Verwenden Sie Variablen, um Ihre App dynamisch zu machen:
   • {{variable_name}} – Benutzereingabe-Variable
   • {{context}} – Kontext der Wissensdatenbank

You are a professional customer service assistant, skilled at answering product questions.

Product Information: {{product_info}}

Please provide accurate and friendly answers based on user questions. If unsure, honestly inform the user.

User Question: {{user_question}}

​

4.2 Wissensdatenbank hinzufügen (optional)

1. Klicken Sie im linken Menü auf Knowledge Base
2. Erstellen Sie eine neue Wissensdatenbank und laden Sie Dokumente hoch
3. Verknüpfen Sie die Wissensdatenbank auf der Anwendungsorchestrierungsseite
4. Konfigurieren Sie die Such-Parameter

​

4.3 Anwendung testen

1. Geben Sie Testfragen im Preview-Panel rechts ein
2. Überprüfen Sie die Wirksamkeit der KI-Antworten
3. Passen Sie Prompts und Parameter nach Bedarf an
4. Wiederholen Sie das Testen, bis Sie zufrieden sind

​

4.4 Anwendung veröffentlichen

1. Klicken Sie oben rechts auf Publish
2. Wählen Sie die Veröffentlichungsmethode:
   • API Call – Integration über API
   • Embed in Website – Embed-Code generieren
   • Public Link – Share-Link generieren

​

Schritt 5: Überwachen und optimieren

​

5.1 Anwendungslogs anzeigen

1. Klicken Sie auf den Tab Logs
2. Sehen Sie alle Konversationsdatensätze ein
3. Analysieren Sie Benutzerfragen und KI-Antworten
4. Entdecken Sie Verbesserungsmöglichkeiten

​

5.2 API-Nutzung überwachen

• 📊 API-Aufrufstatistiken – Gesamtaufrufe, Erfolgsrate
• 💰 Kostendetails – tägliche/monatliche Kosten
• 📈 Nutzungstrends – Veränderungstrends
• 🔍 Anfrage-Logs – detaillierte Anfragedatensätze

​

5.3 Anwendungsleistung optimieren

1. Modellauswahl anpassen
   • gpt-4o-mini für einfache Aufgaben verwenden, um Kosten zu senken
   • gpt-4o oder claude-sonnet-4-5 für komplexe Aufgaben verwenden, um die Qualität zu verbessern
2. Prompts optimieren
   • Prompts klarer und konkreter machen
   • Beispiele für bessere Effektivität hinzufügen
   • Chain-of-Thought für besseres Reasoning verwenden
3. Caching konfigurieren
   • Caching für ähnliche Fragen aktivieren
   • API-Aufrufkosten senken

​

Erweiterte Funktionen

​

Workflow-Orchestrierung verwenden

1. Bedingte Verzweigungen – verschiedene Logik basierend auf Bedingungen ausführen
2. Multi-Modell-Zusammenarbeit – Vorteile mehrerer Modelle kombinieren
3. Externe Tool-Aufrufe – APIs, Datenbanken und andere externe Ressourcen aufrufen
4. Variablenübergabe – Daten zwischen verschiedenen Knoten übergeben

​

Agent-Fähigkeiten konfigurieren

1. Tool-Aufrufe – die KI externe Tools aufrufen lassen
2. Speicherverwaltung – langfristiges Konversationsgedächtnis pflegen
3. Autonome Entscheidungsfindung – die KI plant Ausführungsschritte autonom

​

Multimodale Anwendungen

1. Bildverständnis – gpt-4o oder claude-3 zur Verarbeitung von Bildern verwenden
2. Bilderzeugung – APIMarts Bilderzeugungs-API integrieren
3. Sprachverarbeitung – TTS- und STT-Dienste integrieren

​

FAQ

​

Q1: Keine Verbindung zum APIMart-Dienst möglich?

1. Base URL prüfen:
   • Stellen Sie sicher, dass es https://api.apimart.ai/v1 ist (mit /v1)
   • Fügen Sie keine zusätzlichen Pfade hinzu und lassen Sie /v1 nicht weg
2. API Key überprüfen:
   • Bestätigen Sie, dass der API Key mit sk- beginnt
   • Prüfen Sie die Gültigkeit in der APIMart-Konsole
3. Netzwerkverbindung prüfen:
   • Stellen Sie sicher, dass der Server auf https://api.apimart.ai zugreifen kann
   • Self-hosted-Versionen müssen Server-Netzwerkkonnektivität sicherstellen

​

Q2: Modellantwort ist langsam?

1. Zu schnelleren Modellen wechseln:
   • gpt-4o-mini statt gpt-4o verwenden
   • gemini-2.0-flash-exp für schnellere Antworten verwenden
2. Prompt-Länge optimieren:
   • Unnötigen Kontext reduzieren
   • Prompt-Beschreibungen vereinfachen
3. Wissensdatenbank-Suche anpassen:
   • Anzahl der abgerufenen Dokumente reduzieren
   • Ähnlichkeitsschwelle erhöhen

​

Q3: API-Aufrufe schlagen fehl oder geben Fehler zurück?

​

Q4: Wie können API-Nutzungskosten gesenkt werden?

1. Modellauswahl:
   • gpt-4o-mini für einfache Aufgaben verwenden (Kosten betragen nur 1/10 von gpt-4o)
   • Sparsamere Modelle für Batch-Aufgaben in Betracht ziehen
2. Caching aktivieren:
   • Zwischengespeicherte Ergebnisse für gleiche Fragen zurückgeben
   • Ähnlichkeitsabgleich in Dify konfigurieren
3. Ausgabelänge optimieren:
   • Sinnvolle Max Tokens setzen
   • Übermäßig lange Antworten vermeiden
4. Streaming-Ausgabe verwenden:
   • Verbessert Benutzererlebnis ohne Kostenerhöhung

​

Q5: Wie sensible Daten handhaben?

1. Umgebungsvariablen verwenden:
   • API-Schlüssel nicht im Code fest verdrahten
   • Dify-Umgebungsvariablenfunktion nutzen
2. Zugriffskontrolle konfigurieren:
   • Anwendungszugriffsrechte setzen
   • Authentifizierung für API-Aufrufe aktivieren
3. Audit-Logs:
   • Regelmäßig Anwendungslogs prüfen
   • Anomale Zugriffsmuster überwachen

​

Best Practices

​

1. Prompt-Engineering

# Role Definition
You are a professional [role description]

# Task Objective
You need to help users [task description]

# Output Requirements
- Requirement 1
- Requirement 2
- Requirement 3

# Input Information
{{user_input}}

​

2. Wissensdatenbank-Verwaltung

• Chunking-Strategie: vernünftige Dokumentchunk-Größe (empfohlen 500-1000 Zeichen)
• Metadaten-Tagging: Metadaten zu Dokumenten für leichtere Suche hinzufügen
• Regelmäßige Updates: Inhalt der Wissensdatenbank aktuell halten

​

3. Fehlerbehandlung

• Freundliche Nachrichten: Benutzern klare Fehlermeldungen geben
• Fallback-Strategie: bei Hauptmodellausfall auf Backup-Modell wechseln
• Wiederholungsmechanismus: automatische Wiederholung bei temporären Fehlern

​

4. Leistungsüberwachung

• Alerts setzen: Alerts für niedriges Guthaben, hohe Fehlerraten
• Regelmäßige Analyse: Nutzungsdaten wöchentlich/monatlich analysieren
• Kontinuierliche Optimierung: Konfiguration basierend auf Daten anpassen

​

Anwendungsbeispiele

​

1. Intelligenter Kundenservice

• Modell: gpt-4o-mini (kosteneffizient)
• Wissensdatenbank: Produktdokumente, FAQ
• Funktionen: automatische Beantwortung häufiger Fragen, Eskalation komplexer Anliegen an Menschen

​

2. Content-Creation-Assistent

• Modell: gpt-4o oder claude-sonnet-4-5 (hohe Qualität)
• Funktionen: Artikelgenerierung, Umschreiben, Politur
• Parameter: Temperature=0,8 (Kreativität verstärken)

​

3. Code-Assistent

• Modell: claude-sonnet-4-5 (hervorragend für Code)
• Funktionen: Codegenerierung, -erklärung, Debugging
• Wissensdatenbank: Projektdokumentation, API-Dokumentation

​

4. Datenanalyse-Assistent

• Modell: gpt-4o (starke Reasoning-Fähigkeit)
• Tools: Python-Code-Ausführung, Datenvisualisierung
• Funktionen: Datenanalyse, Berichtsgenerierung

​

Funktionen

• 🤖 Schnell KI-Apps bauen – leistungsstarke KI-Anwendungen ohne Programmierung erstellen
• 📚 Wissensdatenbank-Anreicherung – RAG-Technologie lässt die KI basierend auf Ihren Daten antworten
• 🔧 Flexible Workflows – visuell komplexe KI-Logik orchestrieren
• 🎯 Präzise Prompt-Verwaltung – Versionierung und A/B-Tests
• 📊 Vollständige Überwachung und Analyse – Nutzung und Leistung der App verstehen
• 🔌 Mehrere Integrationsmöglichkeiten – API, eingebettet, WebApp und mehr
• 👥 Team-Zusammenarbeit – Unterstützung für Mehrbenutzer-Entwicklung
• 🌐 Multi-Modell-Unterstützung – flexibel zwischen verschiedenen KI-Modellen wechseln

​

Support & Hilfe

• 📚 APIMart-Dokumentation
• 📚 Offizielle Dify-Dokumentation
• 💬 Discord-Community
• 🐦 Twitter @APIMart_
• 📧 Technischer Support: zhihong@apimart.ai