Respan: Span-01
Span-01 ist der Text-Verhaltensklassifikator von Respan für Gespräche und Agenten-Traces. Sie definieren die Verhaltensweisen in natürlicher Sprache, und das Modell liefert für jede drei Wahrscheinlichkeiten: vorhanden, nicht vorhanden und nicht beobachtbar. So bleibt Unsicherheit erhalten, wenn der bereitgestellte Trace die Frage nicht klären kann.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
Span-01 ist das Verhaltensbewertungsmodell von Respan für Gespräche und Agenten-Traces. Es liest eine Textinteraktion zusammen mit in natürlicher Sprache formulierten Verhaltensdefinitionen und gibt für jede Definition Wahrscheinlichkeiten zurück. Die Ausgabe unterscheidet, ob ein Verhalten im bereitgestellten Trace vorhanden, nicht vorhanden oder nicht beobachtbar ist. Damit erhält ein Evaluierungs-Workflow ein numerisches Signal mit einer expliziten Darstellung fehlender Belege statt einer generierten Erklärung, die erst geparst werden muss.
Das zu beobachtende Verhalten definieren
Verhaltensweisen werden vom Aufrufer bereitgestellt. Prompt Injection, nicht belegte Behauptungen, Offenlegung von Geheimnissen, sich wiederholende Schleifen, Fehlgebrauch von Tools und Nutzerfrustration sind mögliche Definitionen, keine im Modell fest eingebaute Taxonomie. Legen Sie fest, was als das Verhalten gilt und was nicht. Eine enge Definition kann unterscheiden, ob ein Nutzer um Übergabe an einen Menschen bittet oder lediglich Enttäuschung äußert. Eine andere kann unterscheiden, ob ein Assistent ein Problem anerkennt oder eine Aktion verspricht, die er nicht ausführen kann.
Verwenden Sie stabile Bezeichner für die Definitionen, damit die Ergebnisse dem bewerteten Verhalten zugeordnet bleiben. Richten Sie das Kriterium auf etwas aus, das der Trace zeigen kann. Wenn das Verhalten ein Quelldokument, ein Tool-Ergebnis oder eine spätere Kundenantwort erfordert, nehmen Sie diesen Beleg an der passenden Stelle in die Textinteraktion auf. Eine Definition allein kann keine Tatsache belegen, die im Trace fehlt.
Vorangehenden Kontext und Ziel-Gesprächszug vorbereiten
Die dokumentierte Eingabe trennt vorangehende Nachrichten in span.input vom Ziel-Gesprächszug in span.output. Der Inhalt jeder Nachricht ist ein String. Stellen Sie den tatsächlichen Gesprächskontext und den zu bewertenden Gesprächszug bereit und bewahren Sie dabei die Sprecherrollen und die zum Verständnis nötige Reihenfolge. Dies ist ein Textbewertungsprofil; aufbereiteter Dokumenttext oder ein Transkript können Belege sein, während die Medien, aus denen dieser Text gewonnen wurde, selbst nicht die dokumentierte Eingabe sind.
Behalten Sie bei einer Support-Interaktion die Anfrage des Kunden zusammen mit der vorgeschlagenen Antwort des Assistenten. Behalten Sie bei einem Agenten, der Tools nutzt, die relevante Tool-Beobachtung und die Antwort, die sich darauf stützte. Eine beispielhafte Definition zur Fundierung könnte fragen, ob der Assistent eine Schlussfolgerung behauptet, die die bereitgestellte Beobachtung nicht stützt. Das nützliche Ergebnis betrifft das definierte Verhalten in diesem Abschnitt, nicht eine vollständige Diagnose der gesamten Anwendung.
Drei Wahrscheinlichkeiten für jede Definition lesen
Jedes Ergebnis enthält den Verhaltensbezeichner sowie p_present, p_absent und p_not_observable. Die drei Wahrscheinlichkeiten summieren sich zu ungefähr 1. Vorhanden schätzt, dass das Verhalten aufgetreten ist; nicht vorhanden schätzt, dass es nicht aufgetreten ist; nicht beobachtbar schätzt, dass dem bereitgestellten Abschnitt die für eine Entscheidung nötigen Belege fehlen. Das sind getrennte Bedeutungen, die bei der Interpretation der Ergebnisse getrennt bleiben sollten.
Ein Abschnitt, der beispielsweise damit endet, dass ein Assistent sagt, er werde ein Problem lösen, kann ein Versprechen zeigen. Er kann jedoch noch nicht zeigen, dass der Kunde die spätere Lösung angenommen hat, wenn keine Kundenantwort vorliegt. Behandeln Sie dieses Ergebnis mit fehlenden Belegen als unbekannt, statt es in nicht vorhanden umzuwandeln. Eine niedrige Wahrscheinlichkeit für Vorhandensein ist nicht automatisch ein starker Beleg für Nichtvorhandensein, wenn ein erheblicher Teil der Verteilung auf nicht beobachtbar entfällt.
Bewertung über alle Verhaltensdefinitionen in einem Durchlauf
Respan beschreibt Span-01 als Reasoning-Klassifikator, der zunächst mit RLAIF für allgemeine Klassifikation trainiert und dann auf Verhaltenserkennung spezialisiert wurde. Jede Definition läuft als paralleler Zweig über denselben Trace, und das Modell gibt die Verhaltenswahrscheinlichkeiten in einem einzigen Forward Pass zurück. Hybride Attention unterstützt seine Verarbeitung langer, komplexer Traces. Es generiert keine Tokens, schreibt kein erzählendes Urteil und erzeugt keine frei formulierte Erklärung seiner Klassifikation.
Der Konzeptleitfaden und die Bewertungsreferenz dokumentieren keine Obergrenze für die Anzahl der Verhaltensweisen pro Anfrage. Jede Definition ist dennoch Teil der bereitgestellten Auswertung; halten Sie daher jede klar und relevant, statt das Fehlen einer Obergrenze als Beleg für unbegrenzte Eingabekapazität zu werten. Das Ergebnis enthält pro Verhalten einen Eintrag in der Reihenfolge der Anfrage, gekennzeichnet durch seine id. Mehrere Definitionen beschreiben mehrere unabhängige Beobachtungen; sie sind keine sich gegenseitig ausschließenden Kategorieentscheidungen, die sich über alle Verhaltensweisen zu eins summieren müssen.
Ein nützliches Evaluierungsartefakt erstellen
Kombinieren Sie die zurückgegebenen Wahrscheinlichkeiten außerhalb des Modells mit aufgabenspezifischen Schwellenwerten und Prüfregeln. Der Hersteller empfiehlt, diese Schwellenwerte anhand gelabelter Gespräche festzulegen und Grenzfälle beim Vorhandensein oder Ergebnisse mit hohem Nicht-beobachtbar-Wert zu inspizieren. Ein Support-Workflow kann Frustration, eine vorgeschlagene Eskalation und ein nicht belegtes Versprechen getrennt erfassen. Ein Workflow zur Agentenqualität kann wiederholte Aktionen verfolgen oder prüfen, ob eine Antwort die ihr zur Verfügung gestellten Belege genutzt hat.
Bewahren Sie Textabschnitt, Verhaltensdefinition, Ergebnisbezeichner und die vollständige dreiteilige Verteilung gemeinsam auf. Wenn sich die Definition ändert, berücksichtigen Sie, dass sich damit auch ändert, was die Wahrscheinlichkeit misst. Prüfen Sie scheinbare Fehler anhand des tatsächlichen Gesprächs, statt ein numerisches Ergebnis als Beweis für ein nicht beobachtetes Ereignis zu behandeln. Ein nützliches Artefakt ist ein Verhaltensdatensatz, der an Trace und Kriterium gebunden ist und die Unsicherheit für eine spätere Inspektion oder die nächste Entscheidung einer Anwendung bewahrt.
Ailoot Ultra · System One POST /v1/systemone respan/span-01
respan/span-01Start
Span-01 ist der Text-Verhaltensklassifikator von Respan für Gespräche und Agenten-Traces. Sie definieren die Verhaltensweisen in natürlicher Sprache, und das Modell liefert für jede drei Wahrscheinlichkeiten: vorhanden, nicht vorhanden und nicht beobachtbar. So bleibt Unsicherheit erhalten, wenn der bereitgestellte Trace die Frage nicht klären kann.
- Zulässige Eingaben
- Text
- Ergebnisse
- decisions
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · System One POST /v1/systemone
- Eingabetypen
text- Ausgabetypen
decisions- Ausgabeformat
- json
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits respan/span-01 | Standard— |
Feldprovider | Typschema | AnforderungOptional | Werte und Limits | Standard— |
Feldquestions | Typobject | AnforderungErforderlich | Werte und Limits | Standard— |
Feldsession_id | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Feldstate | Typschema | AnforderungErforderlich | Werte und Limits | Standard— |
Feldtrace | Typschema | AnforderungOptional | Werte und Limits | Standard— |
Felduser | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Feldquestions.<id>.type | Typstring | AnforderungErforderlich | Werte und Limits noul, choice, score | Standard— |
Feldquestions.<id>.instructions | Typstring|object|array | AnforderungErforderlich | Werte und Limits | Standard— |
Feldquestions.<id>.criteria | Typobject|array | AnforderungOptional | Werte und Limits Bedingungen: choice/score: erforderlich; noul: optional. Bei choice ist criteria ein Objekt; bei score ist es ein Array mit minItems=1. | Standard— |
Feldquestions.<id>.criteria.true | Typstring|object|array | AnforderungErforderlich | Werte und Limits Gilt, wenn: Kriterienobjekt noul bereitgestellt | Standard— |
Feldquestions.<id>.criteria.false | Typstring|object|array | AnforderungErforderlich | Werte und Limits Gilt, wenn: Kriterienobjekt noul bereitgestellt | Standard— |
Kombinationen von Eingabematerialien
noul · Erforderlich: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Erforderlich: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Erforderlich: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, state, questions |
Parametermaterial_types | Vertragtext |
Parameteroptional_controls | Vertragprovider, session_id, trace, user |
Parametermultimodal_input_binding | Vertragnull |
Lebenszyklus: synchronous
Senden Sie die genaue Modell-ID und bewahren Sie die vollständige native Antwort auf.
Tarife
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Ailoot-Tarife
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Kontexttoken, mehr als | Kontexttoken, bis einschließlich | Gebühr |
|---|---|---|---|---|
| KonfigurationBasistarife für Token | TarifstaffelGrundtarif | Kontexttoken, mehr als— | Kontexttoken, bis einschließlichKeine Obergrenze | Gebühr Eingabe · Eingabetoken $0.00004 / 1K Token Ausgabe · Ausgabetoken $0 / 1K Token Eingabe · Cache-Lesen — / 1K Token Eingabe · Cache-Schreiben — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde — / 1K Token |
| KonfigurationAnfragelängenstufe 1 | Tarifstaffel— | Kontexttoken, mehr als0 | Kontexttoken, bis einschließlichKeine Obergrenze | Gebühr Eingabe · Eingabetoken $0.00004 / 1K Token Ausgabe · Ausgabetoken $0 / 1K Token Eingabe · Cache-Lesen — / 1K Token Eingabe · Cache-Schreiben — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde — / 1K Token |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot Ultra · System One
{
"model": "respan/span-01",
"questions": {
"is_bug": {
"criteria": {
"false": "The customer is asking a question or requesting a feature.",
"true": "The customer describes broken or unexpected product behavior."
},
"instructions": "Is the customer reporting a software defect?",
"type": "noul"
},
"team": {
"criteria": {
"account": "Login, permissions, or profile issues.",
"frontend": "Rendering, layout, or browser compatibility issues.",
"payments": "Checkout, billing, or payment processing issues."
},
"instructions": "Which team should own this ticket?",
"type": "choice"
},
"urgency": {
"criteria": [
"Can wait for the next release",
"Should be fixed this week",
"Blocking revenue right now"
],
"instructions": "How urgent is this ticket?",
"type": "score"
}
},
"state": {
"customer_tier": "enterprise",
"ticket": "My checkout page shows a blank screen after I click Pay. I have tried two browsers."
}
}set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='respan/span-01'
Path('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/systemone \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))
PY_RESULT
Ergebnisse abrufen und speichern
Ailoot Ultra · System One
json
Alle fertiggestellten Ergebnisse aufbewahren
Bewahren Sie jede vollständig zurückgegebene Antwort, Datei und jeden Inhaltsteil auf.
Jede bereitgestellte Antwort mit Fragen-ID bleibt mit ihrem genauen Typ, ihrem noul/choice/score-Wert, ihrer Konfidenz, ihren Wahrscheinlichkeiten und ihrer Legende erhalten. Das gesamte ursprüngliche JSON wird gespeichert und erst nach der Abrechnung zurückgegeben.
Wenn die ursprüngliche Antwort geprüft werden muss
Bewahren Sie den ursprünglichen Vorgang sowie die vollständige oder teilweise Antwort auf; wiederholen Sie POST nicht.
Antwortfelder
| Feld | Typ |
|---|---|
Feldmodel | Typstring |
Feldid | Typstring |
Feldprovider | Typstring |
Feldanswers.<id>.type | Typstring |
Feldanswers.<id>.noul | Typnumber |
Feldanswers.<id>.choice | Typstring |
Feldanswers.<id>.score | Typnumber |
Feldanswers.<id>.confidence | Typnumber |
Feldanswers.<id>.probabilities | Typobject |
Feldanswers.<id>.legend | Typobject |
Feldusage.input_tokens | Typinteger |
Feldusage.output_tokens | Typinteger |
Feldusage.cost | Typnumber |
Fehler und nächste Schritte
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort400 · invalid_request_error | BedingungUngültiges Pflichtfeld, ungültige Darstellung oder ungültiger Wert | Nächster SchrittKorrigieren Sie das angegebene Anfragefeld. |
Aliasnamen
Modellaliasnamen
Ailoot Ultra respan/span-01
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · Respan: Span-01
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/systemone·respan/span-01:text→decisions- Welche Felder verwendet die Anfrage?
POST /v1/systemone·respan/span-01:model,provider,questions,session_id,state,trace,user