AI Solutio Dokumentation

Wie AI Solutio funktioniert

AI Solutio liest ausschließlich die Quellen, die Sie verbinden, beantwortet Fragen gestützt auf diese Inhalte und nennt zu jeder Antwort die Quelle. Wenn Sie es festlegen, übergibt AI Solutio das Gespräch an einen Menschen. Indexierung, Speicherung und Inferenz laufen vollständig in der EU.

Schnellstart

In drei Schritten von der Anmeldung zu einem antwortenden Chat auf Ihrer Website:

1. Workspace anlegen. Registrieren Sie sich und erstellen Sie einen Workspace für Ihre Marke.
2. Eine Quelle hinzufügen. Verbinden Sie Ihre Website-URL, ein PDF oder Notion. AI Solutio indexiert die Inhalte.
3. Das Widget einbinden. Fügen Sie das Snippet vor </body> ein – der Chat ist live.

<!-- vor </body> einfügen -->
<script src="https://cdn.aisolutio.ai/w.js"
        data-site="meadow-oak"></script>

Inhalte verbinden

AI Solutio beantwortet Fragen nur aus den Quellen, die Sie hinzufügen. Nichts aus dem offenen Web fließt ein. Unterstützt werden:

• Website-URL – AI Solutio folgt Ihrer Sitemap und indexiert öffentliche Seiten.
• PDF-Dokumente – laden Sie Handbücher, Richtlinien oder Datenblätter hoch.
• Notion – verbinden Sie einen Arbeitsbereich oder einzelne Seiten.
• Hilfe-Center-Export – importieren Sie bestehende Artikel als Datei.

Quellen werden täglich automatisch neu indexiert. Sie können die Neuindexierung jederzeit manuell auslösen – im Dashboard oder über die API.

Stimme & Leitplanken

Legen Sie fest, wie AI Solutio klingt und wo die Grenzen liegen. Die Leitplanken werden bei jeder Antwort durchgesetzt.

• Ton – formell, freundlich oder knapp; passend zu Ihrer Marke.
• Regeln – z. B. „nie einen Preis nennen“ oder „immer den Link zum Rückgabeportal anbieten“.
• Vorschau – testen Sie Antworten an echten Fragen, bevor Sie live gehen.

Übergabe an Menschen

Sie entscheiden, wann ein Mensch übernimmt. Bei einem Auslöser übergibt AI Solutio das vollständige Gespräch – an Ihr Postfach, an Ihren Helpdesk (Zendesk, Freshdesk) oder per Webhook.

• Themen – etwa Erstattungen oder Verträge.
• Stimmung – verärgerter oder dringlicher Ton.
• Ausdrücklicher Wunsch – der Kunde bittet um einen Menschen.

Entwickler können Übergaben programmatisch empfangen – siehe Webhooks.

Inhaltslücken & Analysen

Das Dashboard zeigt, welche Fragen Ihre Inhalte nicht beantworten konnten, wie hoch Ihre Deflektionsrate ist und welche Quellen am häufigsten zitiert werden. Nutzen Sie die Lücken als To-do-Liste für Ihr Hilfe-Center – jede geschlossene Lücke verbessert die nächste Antwort.

Authentifizierung

Alle API-Anfragen werden mit einem API-Schlüssel als Bearer-Token authentifiziert. Schlüssel erstellen Sie unter Einstellungen → API. Die Basis-URL ist in der EU gehostet.

Authorization: Bearer sk_live_9f2c8a1e...

Antwort-Endpunkt

Senden Sie eine Frage und erhalten Sie eine fundierte Antwort mit Quellenangaben.

Anfrage-Parameter

curl https://api.aisolutio.ai/v1/answer \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "site": "meadow-oak",
    "question": "Can I return a jacket after 3 weeks?",
    "language": "auto"
  }'

import AISolutio from "@aisolutio/sdk";

const aisolutio = new AISolutio({ apiKey: process.env.AISOLUTIO_API_KEY });

const res = await aisolutio.answer({
  site: "meadow-oak",
  question: "Can I return a jacket after 3 weeks?",
  language: "auto",
});

console.log(res.answer);
console.log(res.citations);

from aisolutio import AISolutio

client = AISolutio(api_key=os.environ["AISOLUTIO_API_KEY"])

res = client.answer(
    site="meadow-oak",
    question="Can I return a jacket after 3 weeks?",
    language="auto",
)

print(res.answer)
print(res.citations)

Antwort (Response)

Die Antwort enthält den Text, die genutzten Quellen und ob eine Übergabe ausgelöst wurde.

{
  "answer": "Yes — unworn items can be returned within 30 days...",
  "citations": [
    { "source": "Returns Policy", "section": "§2", "url": "https://meadow-oak.com/returns" }
  ],
  "handoff": false,
  "conversation_id": "conv_8sKd2b1"
}

Quellen verwalten

Fügen Sie Inhaltsquellen programmatisch hinzu, listen Sie sie auf, indexieren Sie sie neu oder entfernen Sie sie.

Quelle hinzufügen

curl https://api.aisolutio.ai/v1/sources \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "type": "url", "location": "https://meadow-oak.com" }'

Konversationen

Ruft einen vollständigen Gesprächsverlauf ab – inklusive aller Nachrichten und der jeweils genutzten Quellen. Nützlich für Prüfungen und um nachzuvollziehen, warum eine Antwort so ausfiel.

curl https://api.aisolutio.ai/v1/conversations/conv_8sKd2b1 \
  -H "Authorization: Bearer sk_live_xxx"

Webhooks

Abonnieren Sie Ereignisse, um in Echtzeit zu reagieren. Das wichtigste Ereignis ist handoff.requested – es wird ausgelöst, sobald ein Gespräch an einen Menschen übergeben wird. Den Endpunkt konfigurieren Sie unter Einstellungen → Webhooks.

{
  "event": "handoff.requested",
  "conversation_id": "conv_8sKd2b1",
  "reason": "refund",
  "transcript_url": "https://api.aisolutio.ai/v1/conversations/conv_8sKd2b1"
}

Fehler & Limits

Die API verwendet Standard-HTTP-Statuscodes. Fehler geben ein JSON-Objekt mit Code und Nachricht zurück.

{ "error": { "code": "invalid_site", "message": "No workspace named 'meadow-oak'." } }

Ratenlimits

Anfragen pro Minute richten sich nach Ihrem Tarif: Starter 60, Growth 300, Scale 1.000. Zusätzlich gilt Ihr monatliches Kontingent an beantworteten Chats aus der Preisübersicht.

SDKs

Offizielle SDKs für Node und Python nehmen Ihnen Authentifizierung und Wiederholungen ab.

npm install @aisolutio/sdk

pip install aisolutio