Zum Inhalt

🤖 Erklären mit KI

Mit KI entwickeln

Diese Anleitung führt Sie durch die Erstellung von Produkten auf der 4Geeks-Plattform und deren Integration mit unseren KI-Fähigkeiten – KI-Agenten und KI-Studio – um intelligente, automatisierte Workflows zu erstellen.

Produkte erstellen

Produkte bei 4Geeks repräsentieren die Waren, Dienstleistungen oder Abonnementpläne, die Sie anbieten. Sie können Produkte programmgesteuert über die REST-API erstellen und verwalten.

API-Authentifizierung

Alle API-Anfragen erfordern Ihren Live-API-Schlüssel, der über den X-Api-Key-Header übergeben wird:

X-Api-Key: sk_live_your_api_key_here

Holen Sie sich Ihre API-Schlüssel aus dem Dashboard Plattform-Einstellungen unter dem Tab API & Webhooks. Siehe API-Schlüssel abrufen für Details.

Ein Produkt erstellen

Senden Sie eine POST-Anfrage, um ein Produkt zu erstellen:

curl -X POST 'https://api.4geeks.io/v1/products' \
  -H 'X-Api-Key: sk_live_your_api_key_here' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Premium Plan",
    "description": "Full-featured premium subscription with priority support",
    "active": true
  }'

import requests

response = requests.post(
    'https://api.4geeks.io/v1/products',
    headers={
        'X-Api-Key': 'sk_live_your_api_key_here',
        'Content-Type': 'application/json'
    },
    json={
        'name': 'Premium Plan',
        'description': 'Full-featured premium subscription with priority support',
        'active': True
    }
)
print(response.json())

const response = await fetch('https://api.4geeks.io/v1/products', {
    method: 'POST',
    headers: {
        'X-Api-Key': 'sk_live_your_api_key_here',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        name: 'Premium Plan',
        description: 'Full-featured premium subscription with priority support',
        active: true
    })
});
const data = await response.json();
console.log(data);

Die Antwort enthält das erstellte Produkt mit seiner ID:

{
    "id": "prod_abc123",
    "name": "Premium Plan",
    "description": "Full-featured premium subscription with priority support",
    "active": true,
    "created_at": "2026-05-02T10:30:00Z"
}

Produkte auflisten

Rufen Sie alle Ihre Produkte mit Paginierung ab:

curl -X GET 'https://api.4geeks.io/v1/products?limit=10&offset=0' \
  -H 'X-Api-Key: sk_live_your_api_key_here'

import requests

response = requests.get(
    'https://api.4geeks.io/v1/products',
    headers={'X-Api-Key': 'sk_live_your_api_key_here'},
    params={'limit': 10, 'offset': 0}
)
print(response.json())

Antwort:

{
    "items": [
        {
            "id": "prod_abc123",
            "name": "Premium Plan",
            "description": "Full-featured premium subscription with priority support",
            "active": true
        }
    ],
    "total_items": 1,
    "limit": 10,
    "offset": 0
}

Einen Plan für ein Produkt erstellen

Für abonnementbasierte Produkte erstellen Sie einen Plan, der mit Ihrem Produkt verknüpft ist:

curl -X POST 'https://api.4geeks.io/v1/plans' \
  -H 'X-Api-Key: sk_live_your_api_key_here' \
  -H 'Content-Type: application/json' \
  -d '{
    "product_id": "prod_abc123",
    "amount": 4999,
    "currency": "USD",
    "interval": "month"
  }'

Der amount-Wert ist in Cents (4999 = $49.99). Unterstützte Intervalle: month, year, week.

Integration von Produkten mit KI-Agenten

Sobald Ihre Produkte erstellt sind, können Sie sie mit 4Geeks KI-Agenten verbinden, um Vertriebs-, Support- und Inkasso-Workflows zu automatisieren.

So funktioniert es

4Geeks KI-Agenten nutzen Ihren Produktkatalog und Ihre Dokumentation als Wissensbank. Wenn ein Kunde mit einem Agenten interagiert, kann er:

  • Produkte empfehlen basierend auf Kundenbedürfnissen
  • Fragen beantworten zu Preisen, Funktionen und Verfügbarkeit
  • Bestellungen verarbeiten und Checkout-Sitzungen erstellen
  • Support-Tickets behandeln, die sich auf bestimmte Produkte beziehen

Schritt-für-Schritt: Produkte mit einem KI-Vertriebsagenten verbinden

1. Einen KI-Vertriebsagenten bereitstellen

Navigieren Sie zur 4Geeks-Konsole und klicken Sie auf Agent bereitstellen. Wählen Sie KI-Vertriebsagent und geben Sie ihm einen Namen.

2. Die Schulungsdatenquelle einstellen

Geben Sie in der Agentenkonfiguration Ihre Produkt-Dokumentations-URL als Schulungsdatenquelle ein. Dies kann sein:

  • Ihre Produktkatalogseite
  • Eine Preisseite
  • API-Dokumentation
  • Eine öffentliche llms.txt-Datei (siehe unten)

Der Agent crawlt diese URL und verwendet den Inhalt, um Kundenfragen genau zu beantworten.

3. Das Agentenziel definieren

Setzen Sie ein klares Ziel für den Agenten:

Sell our software products. When a customer asks about features, recommend the
appropriate plan based on their needs. Always mention pricing in USD. Do not
offer discounts higher than 10% without escalation.

4. Einen Kanal verbinden

Wählen Sie aus, wie Kunden mit dem Agenten interagieren sollen:

  • WhatsApp: Verbinden Sie Ihr Meta Business-Konto für Nachrichten
  • Web-Chat: Betten Sie den Agenten auf Ihrer Website ein
  • Sprache: Aktivieren Sie Telefoninteraktionen

Siehe Wie man einen WhatsApp-KI-Agenten erstellt für eine detaillierte Anleitung.

5. Testen und Online gehen

Der Agent läuft zuerst in einer Sandbox-Umgebung. Testen Sie Interaktionen wie:

Customer: "What plans do you offer?"
Agent: "We have three plans: Basic ($19/mo), Pro ($49/mo), and Premium ($99/mo). 
        The Pro plan includes priority support and API access. Would you like to 
        know more about any specific plan?"

Customer: "I need API access for my team of 10."
Agent: "For a team of 10 with API access, I recommend the Pro plan at $49/mo per 
        seat. Would you like me to send you a checkout link to get started?"

Sobald Sie zufrieden sind, klicken Sie auf Online gehen, um den Agenten in die Produktion zu bringen.

KI-Agenten + Produkt-Workflow

So funktioniert die vollständige Integration:

sequenceDiagram
    participant C as Customer
    participant A as AI Agent
    participant K as Knowledge Base
    participant P as 4Geeks API
    participant O as Checkout

    C->>A: "What products do you have?"
    A->>K: Query product catalog
    K-->>A: Return product data
    A-->>C: List products with pricing
    C->>A: "I want the Premium Plan"
    A->>P: Create checkout session
    P-->>A: Return checkout_url
    A-->>C: Send checkout link
    C->>O: Complete payment

KI-Supportagent für Produktanfragen

Stellen Sie einen KI-Kundensupportagenten bereit, um nachverkaufliche Produktfragen zu bearbeiten:

  1. Setzen Sie die Schulungsdatenquelle auf Ihre Produktdokumentation und FAQ
  2. Definieren Sie das Ziel:
Answer customer questions about our products. Help with troubleshooting, 
billing inquiries, and feature explanations. Escalate to a human agent 
if the issue cannot be resolved within 3 interactions.
  1. Verbinden Sie Ihren bevorzugten Kanal (WhatsApp, Web-Chat oder Sprache)

Der Supportagent kann bestimmte Produkte nach ID referenzieren und Echtzeitdaten aus Ihrem Katalog abrufen.

Integration mit KI-Studio

Für benutzerdefinierte produktbezogene Funktionen, die über vorgefertigte Agenten hinausgehen, verwenden Sie 4Geeks KI-Studio.

Was ist KI-Studio?

KI-Studio bietet einen erfahrenen menschlichen Senior-Architekten, verstärkt durch die 4Geeks KI-Factory – eine Infrastruktur, die erstklassige LLMs (Claude, Gemini, GPT) orchestriert, um Code bis zu 5x schneller zu schreiben, zu testen und zu refactoren.

Anwendungsfälle für die Produktintegration

  • Benutzerdefinierte Checkout-Abläufe: Erstellen Sie maßgeschneiderte Zahlungserlebnisse für Ihre Produkte
  • Produktempfehlungssystem: Erstellen Sie ein KI-gestütztes Empfehlungssystem
  • Automatisierte Produktbeschreibungen: Generieren und aktualisieren Sie Produktinhalte im großen Maßstab
  • Benutzerdefinierte Integrationen: Verbinden Sie Ihren Produktkatalog mit Drittanbieter-Tools (CRM, ERP, Analytik)

Loslegen

  1. Gehen Sie zur 4Geeks-Konsole
  2. Beschreiben Sie Ihre Produktintegrationsanforderungen
  3. Ein Senior-Architekt wird Ihrem Projekt zugewiesen
  4. Die KI-Factory beschleunigt die Entwicklung mit Multi-Modell-Orchestrierung
  5. Überprüfen Sie Pull Requests und bringen Sie sie in die Produktion

Siehe die KI-Studio-Übersicht und Privates KI-Gateway für weitere Details.

Verwendung von llms.txt für die KI-Integration

4Geeks veröffentlicht eine öffentliche llms.txt-Datei unter:

https://docs.4geeks.io/llms.txt

Was ist llms.txt?

llms.txt ist eine standardisierte Datei, die KI-Werkzeugen und LLMs einen prägnanten, maschinenlesbaren Überblick über die 4Geeks-API bietet. Sie enthält:

  • Basis-URL und Authentifizierungsdetails
  • Alle verfügbaren Endpunkte mit Methoden, Pfaden und Beschreibungen
  • Anfrage-/Antwortformate
  • Code-Beispiele in mehreren Sprachen
  • Fehlercodes und Muster

Wie man es verwendet

Sie können Ihre KI-Agenten, benutzerdefinierten LLM-Anwendungen oder KI-Entwicklungswerkzeuge auf diese Datei verweisen lassen, damit sie die 4Geeks-API-Struktur ohne manuelle Konfiguration verstehen:

  1. KI-Agenten-Schulungsdaten: Fügen Sie https://docs.4geeks.io/llms.txt als Schulungsdatenquelle für Ihre KI-Agenten hinzu
  2. LLM-Kontext: Fügen Sie den Dateiinhalt in Ihre Systemaufforderungen ein, wenn Sie benutzerdefinierte KI-Anwendungen erstellen
  3. KI-gestützte Entwicklung: IDE-KI-Assistenten (Cursor, Copilot usw.) können diese Datei referenzieren, um korrekte API-Aufrufe zu generieren

Beispiel: Verwendung von llms.txt in einer Systemaufforderung

You are an AI assistant that helps users integrate with the 4Geeks platform.
Use the following API reference to generate correct API calls:

[Content from https://docs.4geeks.io/llms.txt]

Dies stellt sicher, dass die KI genauen Code mit den richtigen Endpunkten, Headern und Anfrageformaten generiert.

Nächste Schritte

Noch Fragen? Get support or explore tutorials