Respan: Span-01
Span-01 ist Respans Text-Verhaltensklassifikator für Gespräche und Agenten-Traces. Definieren Sie die Verhaltensweisen in natürlicher Sprache; das Modell gibt für jede drei Wahrscheinlichkeiten zurück: vorhanden, nicht vorhanden und nicht beobachtbar. So bleibt die 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 Respans Modell zur Verhaltensbewertung für Gespräche und Agenten-Traces. Es liest eine Textinteraktion zusammen mit natürlichsprachlichen 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. Dadurch erhält ein Bewertungsworkflow ein numerisches Signal mit einer ausdrücklichen 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, unbelegte Behauptungen, die Offenlegung von Geheimnissen, Wiederholungsschleifen, Werkzeugmissbrauch und Nutzerfrustration sind mögliche Definitionen und keine feste, im Modell eingebaute Taxonomie. Geben Sie an, was als Verhalten zählt und was nicht. Eine eng gefasste Definition kann einen Nutzer, der eine Übergabe an einen Menschen verlangt, von blosser Enttäuschung unterscheiden. Eine andere kann unterscheiden, ob ein Assistent ein Problem anerkennt oder eine Aktion verspricht, die er nicht ausführen kann.
Verwenden Sie stabile Kennungen bei den Definitionen, damit Ergebnisse mit dem bewerteten Verhalten verknüpft bleiben. Fokussieren Sie das Kriterium auf etwas, das der Trace zeigen kann. Erfordert das Verhalten ein Quelldokument, ein Werkzeugergebnis oder eine spätere Kundenantwort, fügen Sie diesen Beleg an der passenden Stelle in die Textinteraktion ein. Eine Definition allein kann keinen Fakt belegen, der im Trace fehlt.
Vorangehenden Kontext und Zielbeitrag vorbereiten
Die dokumentierte Eingabe trennt vorangehende Nachrichten in span.input vom Zielbeitrag in span.output. Der Inhalt jeder Nachricht ist eine Zeichenfolge. Stellen Sie den tatsächlichen Gesprächskontext und den zu bewertenden Beitrag bereit und bewahren Sie Sprecherrollen sowie die zum Verständnis nötige Reihenfolge. Dies ist ein Textbewertungsprofil; vorbereiteter Dokumenttext oder ein Transkript können als Belege dienen, während die Medien, aus denen der Text gewonnen wurde, selbst nicht die dokumentierte Eingabe sind.
Bewahren Sie bei einer Support-Interaktion die Kundenanfrage zusammen mit der vorgeschlagenen Antwort des Assistenten. Halten Sie bei einem werkzeugnutzenden Agenten die relevante Werkzeugbeobachtung und die darauf gestützte Antwort fest. Eine beispielhafte Definition zur Beleggrundlage könnte fragen, ob der Assistent eine Schlussfolgerung behauptet, die die bereitgestellte Beobachtung nicht unterstützt. Das nützliche Ergebnis betrifft das definierte Verhalten in diesem Ausschnitt und keine vollständige Diagnose der gesamten Anwendung.
Drei Wahrscheinlichkeiten für jede Definition lesen
Jedes Ergebnis enthält die Verhaltenskennung und p_present, p_absent sowie p_not_observable. Die drei Wahrscheinlichkeiten summieren sich ungefähr zu 1. Vorhanden schätzt ein, dass das Verhalten auftrat; nicht vorhanden schätzt ein, dass es nicht auftrat; nicht beobachtbar schätzt ein, dass dem bereitgestellten Ausschnitt die nötigen Belege zur Entscheidung fehlen. Dies sind getrennte Bedeutungen, die bei der Ergebnisinterpretation getrennt bleiben sollten.
Ein Ausschnitt, der beispielsweise damit endet, dass ein Assistent die Lösung eines Problems zusagt, kann ein Versprechen zeigen. Er kann noch nicht zeigen, dass der Kunde die spätere Lösung akzeptiert hat, wenn keine Kundenantwort vorhanden ist. Behandeln Sie dieses Ergebnis mit fehlenden Belegen als unbekannt, statt es in nicht vorhanden umzudeuten. Eine niedrige Vorhandenseinswahrscheinlichkeit ist nicht automatisch ein starker Beleg für Nichtvorhandensein, wenn ein erheblicher Anteil der Verteilung auf nicht beobachtbar entfällt.
Bewertung mehrerer 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 Vorwärtsdurchlauf zurück. Hybride Attention unterstützt die Verarbeitung langer, komplexer Traces. Das Modell generiert keine Tokens, verfasst kein erzählendes Urteil und erzeugt keine freie Erklärung seiner Klassifikation.
Der Konzeptleitfaden und die Bewertungsreferenz dokumentieren keine Grenze für die Anzahl der Verhaltensdefinitionen pro Anfrage. Jede Definition bleibt Teil der bereitgestellten Bewertung; halten Sie daher jede klar und relevant, statt aus dem Fehlen einer Anzahlgrenze eine unbegrenzte Eingabekapazität abzuleiten. Das Ergebnis enthält einen Eintrag pro Verhalten in Anfragereihenfolge, identifiziert durch seine id. Mehrere Definitionen beschreiben mehrere unabhängige Beobachtungen; sie sind keine sich gegenseitig ausschliessenden Kategorieentscheidungen, deren Werte sich über Verhaltensweisen hinweg zu eins summieren müssen.
Ein nützliches Bewertungsartefakt vorbereiten
Kombinieren Sie die zurückgegebenen Wahrscheinlichkeiten ausserhalb des Modells mit aufgabenspezifischen Schwellenwerten und Prüfregeln. Der Anbieter empfiehlt, gekennzeichnete Gespräche zur Wahl dieser Schwellenwerte zu verwenden und grenzwertige Vorhandenseins- oder hohe Nicht-beobachtbar-Ergebnisse zu prüfen. Ein Support-Workflow kann Frustration, eine vorgeschlagene Eskalation und ein unbelegtes Versprechen getrennt protokollieren. Ein Workflow zur Agentenqualität kann wiederholte Aktionen verfolgen oder prüfen, ob eine Antwort die bereitgestellten Belege verwendet hat.
Bewahren Sie Textausschnitt, Verhaltensdefinition, Ergebniskennung und die vollständige dreiteilige Verteilung zusammen auf. Erkennen Sie bei einer Änderung der Definition an, dass sich dadurch ä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 unbeobachtetes Ereignis zu behandeln. Ein nützliches Artefakt ist ein mit Trace und Kriterium verknüpfter Verhaltensdatensatz, dessen Unsicherheit für spätere Prüfung oder die nächste Entscheidung einer Anwendung erhalten bleibt.
Ailoot Ultra · System One POST /v1/systemone respan/span-01
respan/span-01Einstieg
Span-01 ist Respans Text-Verhaltensklassifikator für Gespräche und Agenten-Traces. Definieren Sie die Verhaltensweisen in natürlicher Sprache; das Modell gibt für jede drei Wahrscheinlichkeiten zurück: vorhanden, nicht vorhanden und nicht beobachtbar. So bleibt die 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
- Eingabe
text- Ausgabe
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. Die Kriterien von choice sind ein Objekt; score ist ein Array mit minItems1. | 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 exakte 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 einschliesslich | Gebühr |
|---|---|---|---|---|
| KonfigurationBasistarife für Token | TarifstaffelGrundtarif | Kontexttoken, mehr als— | Kontexttoken, bis einschliesslichKeine Obergrenze | Gebühr Eingabe · Eingabetoken $0.00004 / 1K Tokens Ausgabe · Ausgabetoken $0 / 1K Tokens Eingabe · Cache lesen — / 1K Tokens Eingabe · Cache schreiben — / 1K Tokens Eingabe · Cache schreiben, 1 Stunde — / 1K Tokens |
| KonfigurationAnfragelängenstufe 1 | Tarifstaffel— | Kontexttoken, mehr als0 | Kontexttoken, bis einschliesslichKeine Obergrenze | Gebühr Eingabe · Eingabetoken $0.00004 / 1K Tokens Ausgabe · Ausgabetoken $0 / 1K Tokens Eingabe · Cache lesen — / 1K Tokens Eingabe · Cache schreiben — / 1K Tokens Eingabe · Cache schreiben, 1 Stunde — / 1K Tokens |
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 abschliessenden 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 gelieferte Antwort zu einer Frage-ID bleibt mit ihrem exakten Typ, dem noul/choice/score-Wert, der Konfidenz, den Wahrscheinlichkeiten und der Legende erhalten. Das vollständige 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