Respan: Span-01
Span-01 to tekstowy klasyfikator zachowań Respan dla rozmów i śladów działania agentów. Zdefiniuj zachowania zwykłym językiem, a zwróci dla każdego trzy prawdopodobieństwa: obecne, nieobecne i niemożliwe do zaobserwowania, zachowując niepewność, gdy dostarczony ślad nie rozstrzyga pytania.
O modelu
Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.
Span-01 to model Respan do oceniania zachowań w rozmowach i śladach działania agentów. Odczytuje interakcję tekstową wraz z definicjami zachowań zapisanymi zwykłym językiem i zwraca prawdopodobieństwa dla każdej definicji. Wyjście rozróżnia zachowanie obecne, nieobecne lub niemożliwe do zaobserwowania w dostarczonym śladzie. Daje to procesowi ewaluacji sygnał liczbowy z jawnym sposobem przedstawiania brakujących dowodów, zamiast wygenerowanego wyjaśnienia wymagającego parsowania.
Zdefiniuj zachowanie, które chcesz obserwować
Zachowania dostarcza wywołujący. Wstrzyknięcie promptu, nieuzasadnione twierdzenia, ujawnienie sekretów, powtarzające się pętle, niewłaściwe użycie narzędzi i frustracja użytkownika to możliwe definicje, a nie stała taksonomia wbudowana w model. Określ, co liczy się jako dane zachowanie, a co nie. Wąska definicja może odróżnić prośbę użytkownika o przekazanie do człowieka od samego wyrażenia rozczarowania. Inna może rozróżnić przyznanie przez asystenta, że istnieje problem, od obietnicy działania, którego nie potrafi wykonać.
Używaj stałych identyfikatorów z definicjami, aby wyniki pozostały związane z ocenianym zachowaniem. Skup kryterium na czymś, co ślad może pokazać. Jeśli zachowanie wymaga dokumentu źródłowego, wyniku narzędzia lub późniejszej odpowiedzi klienta, dołącz ten materiał we właściwym miejscu interakcji tekstowej. Sama definicja nie może potwierdzić faktu nieobecnego w śladzie.
Przygotuj wcześniejszy kontekst i docelową turę
Udokumentowane wejście oddziela wcześniejsze wiadomości w span.input od docelowej tury w span.output. Treść każdej wiadomości jest ciągiem znaków. Podaj rzeczywisty kontekst rozmowy i turę, którą chcesz ocenić, zachowując role rozmówców oraz kolejność potrzebną do jej interpretacji. To profil oceniania tekstu; przygotowany tekst dokumentu lub transkrypcja mogą być materiałem dowodowym, natomiast media, z których uzyskano tekst, same nie są udokumentowanym wejściem.
W interakcji ze wsparciem zachowaj prośbę klienta z proponowaną odpowiedzią asystenta. W przypadku agenta korzystającego z narzędzi zachowaj istotną obserwację narzędzia i odpowiedź, która się na niej opierała. Przykładowa definicja sprawdzająca oparcie w materiale może pytać, czy asystent stwierdza wniosek, którego dostarczona obserwacja nie uzasadnia. Użyteczny wynik dotyczy zdefiniowanego zachowania w danym fragmencie, a nie pełnej diagnozy całej aplikacji.
Odczytaj trzy prawdopodobieństwa dla każdej definicji
Każdy wynik zawiera identyfikator zachowania oraz p_present, p_absent i p_not_observable. Suma trzech prawdopodobieństw wynosi w przybliżeniu 1. Obecność szacuje, że zachowanie wystąpiło; nieobecność — że nie wystąpiło; brak możliwości obserwacji — że dostarczony fragment nie zawiera dowodów niezbędnych do rozstrzygnięcia. Są to odrębne znaczenia i powinny pozostać odrębne podczas interpretacji wyników.
Na przykład fragment kończący się stwierdzeniem asystenta, że rozwiąże problem, może pokazywać obietnicę. Nie może jeszcze pokazywać, że klient zaakceptował późniejsze rozwiązanie, jeśli nie ma odpowiedzi klienta. Traktuj taki wynik wynikający z braku dowodów jako nieznany, zamiast zamieniać go na nieobecność. Niskie prawdopodobieństwo obecności nie jest automatycznie silnym dowodem nieobecności, gdy znaczna część rozkładu oznacza brak możliwości obserwacji.
Ocenianie definicji zachowań w jednym przebiegu
Respan opisuje Span-01 jako klasyfikator rozumujący, trenowany najpierw do ogólnej klasyfikacji z użyciem RLAIF, a następnie wyspecjalizowany w wykrywaniu zachowań. Każda definicja działa jako równoległa gałąź na tym samym śladzie, a model zwraca prawdopodobieństwa zachowań w jednym przebiegu w przód. Hybrydowy mechanizm uwagi wspiera obsługę długich, złożonych śladów. Model nie generuje tokenów, nie pisze narracyjnego osądu ani nie tworzy swobodnego wyjaśnienia klasyfikacji.
Przewodnik po pojęciach i dokumentacja oceniania nie podają limitu liczby zachowań w jednym żądaniu. Każda definicja nadal stanowi część dostarczonej ewaluacji, dlatego powinna być jasna i istotna; brak limitu liczby nie dowodzi nieograniczonej pojemności wejścia. Wynik zawiera jeden wpis na zachowanie w kolejności żądania, identyfikowany przez jego id. Wiele definicji opisuje wiele niezależnych obserwacji; nie są to wzajemnie wykluczające się wybory kategorii, których wartości muszą sumować się do jedności między zachowaniami.
Przygotowanie użytecznego artefaktu ewaluacyjnego
Łącz zwrócone prawdopodobieństwa z progami właściwymi dla zadania i regułami przeglądu poza modelem. Producent zaleca używanie oznaczonych rozmów do wyboru tych progów i analizowanie granicznych wyników obecności lub wysokich wyników braku możliwości obserwacji. Proces wsparcia może osobno rejestrować frustrację, proponowaną eskalację i nieuzasadnioną obietnicę. Proces kontroli jakości agenta może śledzić powtarzające się działania lub to, czy odpowiedź wykorzystała udostępniony jej materiał.
Zachowaj razem fragment tekstu, definicję zachowania, identyfikator wyniku i pełny rozkład trójdzielny. Gdy definicja się zmienia, uwzględnij, że zmienia się to, co mierzy prawdopodobieństwo. Weryfikuj pozorne błędy w odniesieniu do rzeczywistej rozmowy, zamiast traktować wynik liczbowy jako dowód niezaobserwowanego zdarzenia. Użyteczny artefakt to rekord zachowania powiązany ze śladem i kryterium, z niepewnością zachowaną do późniejszej analizy lub następnej decyzji aplikacji.
Ailoot Ultra · System One POST /v1/systemone respan/span-01
respan/span-01Start
Span-01 to tekstowy klasyfikator zachowań Respan dla rozmów i śladów działania agentów. Zdefiniuj zachowania zwykłym językiem, a zwróci dla każdego trzy prawdopodobieństwa: obecne, nieobecne i niemożliwe do zaobserwowania, zachowując niepewność, gdy dostarczony ślad nie rozstrzyga pytania.
- Akceptowane dane wejściowe
- Tekst
- Wyniki
- decisions
Dostępne w Ailoot · dane wejściowe i metody
Ailoot Ultra · System One POST /v1/systemone
- Wejście
text- Wyjście
decisions- Format wyjściowy
- json
| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity respan/span-01 | Domyślnie— |
Poleprovider | Typschema | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
Polequestions | Typobject | WymaganieWymagane | Wartości i limity | Domyślnie— |
Polesession_id | Typstring | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
Polestate | Typschema | WymaganieWymagane | Wartości i limity | Domyślnie— |
Poletrace | Typschema | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
Poleuser | Typstring | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
Polequestions.<id>.type | Typstring | WymaganieWymagane | Wartości i limity noul, choice, score | Domyślnie— |
Polequestions.<id>.instructions | Typstring|object|array | WymaganieWymagane | Wartości i limity | Domyślnie— |
Polequestions.<id>.criteria | Typobject|array | WymaganieOpcjonalne | Wartości i limity Warunki: choice/score: wymagane; noul: opcjonalne. Kryteria choice są obiektem; score jest tablicą z minItems1. | Domyślnie— |
Polequestions.<id>.criteria.true | Typstring|object|array | WymaganieWymagane | Wartości i limity Obowiązuje, gdy: Przekazano obiekt kryteriów noul | Domyślnie— |
Polequestions.<id>.criteria.false | Typstring|object|array | WymaganieWymagane | Wartości i limity Obowiązuje, gdy: Przekazano obiekt kryteriów noul | Domyślnie— |
Kombinacje materiałów wejściowych
noul · Wymagane: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Wymagane: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Wymagane: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Parametry i cykl życia metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, state, questions |
Parametrmaterial_types | Kontrakttext |
Parametroptional_controls | Kontraktprovider, session_id, trace, user |
Parametrmultimodal_input_binding | Kontraktnull |
Cykl życia: synchronous
Wyślij dokładny identyfikator modelu i zachowaj kompletną natywną odpowiedź.
Cennik
Informacje taryfowe nie dodają opcji żądania. Obsługiwane parametry podano przy wybranej metodzie.
- Tryb szybki
- Nie określono Gdy wybrany jest tryb szybki
- Tryb flex
- Nie określono Gdy wybrany jest tryb flex
- Maksymalna intensywność rozumowania
- Nie określono Gdy dla maksymalnej intensywności rozumowania stosowana jest domyślna korekta (default)
Stawki Ailoot
Ceny według konfiguracji
Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.
| Konfiguracja | Tabela stawek | Tokeny kontekstu, więcej niż | Tokeny kontekstu, do podanej wartości włącznie | Opłata |
|---|---|---|---|---|
| KonfiguracjaPodstawowe stawki za tokeny | Tabela stawekStawka podstawowa | Tokeny kontekstu, więcej niż— | Tokeny kontekstu, do podanej wartości włącznieBez górnej granicy | Opłata Wejście · Tokeny wejściowe $0.00004 / 1K tokenów Wyjście · Tokeny wyjściowe $0 / 1K tokenów Wejście · Odczyt cache — / 1K tokenów Wejście · Zapis do cache — / 1K tokenów Wejście · Zapis do cache, 1 godz. — / 1K tokenów |
| KonfiguracjaPrzedział długości żądania 1 | Tabela stawek— | Tokeny kontekstu, więcej niż0 | Tokeny kontekstu, do podanej wartości włącznieBez górnej granicy | Opłata Wejście · Tokeny wejściowe $0.00004 / 1K tokenów Wyjście · Tokeny wyjściowe $0 / 1K tokenów Wejście · Odczyt cache — / 1K tokenów Wejście · Zapis do cache — / 1K tokenów Wejście · Zapis do cache, 1 godz. — / 1K tokenów |
Ailoot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →
Przykładowe żądania
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
Odbieranie i zapisywanie wyników
Ailoot Ultra · System One
json
Zachowaj wszystkie ukończone wyniki
Zachowaj każdą kompletną zwróconą odpowiedź, plik i część treści.
Zachowywana jest każda odpowiedź przypisana do podanego identyfikatora pytania wraz z dokładnym typem, wartością noul/choice/score, pewnością, prawdopodobieństwami i legendą. Cały oryginalny JSON jest zapisywany i zwracany dopiero po rozliczeniu.
Jeśli trzeba sprawdzić pierwotną odpowiedź
Zachowaj pierwotną operację oraz pełną lub częściową odpowiedź; nie ponawiaj POST.
Pola odpowiedzi
| Pole | Typ |
|---|---|
Polemodel | Typstring |
Poleid | Typstring |
Poleprovider | Typstring |
Poleanswers.<id>.type | Typstring |
Poleanswers.<id>.noul | Typnumber |
Poleanswers.<id>.choice | Typstring |
Poleanswers.<id>.score | Typnumber |
Poleanswers.<id>.confidence | Typnumber |
Poleanswers.<id>.probabilities | Typobject |
Poleanswers.<id>.legend | Typobject |
Poleusage.input_tokens | Typinteger |
Poleusage.output_tokens | Typinteger |
Poleusage.cost | Typnumber |
Błędy i dalsze kroki
| Odpowiedź | Warunek | Następny krok |
|---|---|---|
Odpowiedź400 · invalid_request_error | WarunekNieprawidłowe wymagane pole, reprezentacja lub wartość | Następny krokPopraw wskazane pole żądania. |
Aliasy
Aliasy modelu
Ailoot Ultra respan/span-01
Aliasy ścieżek metod
Użyj ścieżek metod podanych powyżej.
Powiązane ID modeli
FAQ · Respan: Span-01
- Jakie dane wejściowe i wyniki są dostępne?
POST /v1/systemone·respan/span-01:text→decisions- Jakich pól używa żądanie?
POST /v1/systemone·respan/span-01:model,provider,questions,session_id,state,trace,user