Respan: Span-01 Lite
Span-01 Lite to osobno nazwany profil Respan do oceniania zachowań w rozmowach tekstowych i śladach działania agentów. Korzysta z zachowań zdefiniowanych przez wywołującego i zwraca dla każdego prawdopodobieństwa obecności, nieobecności i braku możliwości obserwacji, w tym samym udokumentowanym procesie oceniania co Span-01.
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 Lite to osobno nazwany profil modelu z rodziny Respan Span-01 do oceniania zachowań. Przewodnik szybkiego startu i tabela modeli producenta wskazują Lite jako jeden z dwóch profili korzystających z tego samego procesu oceniania. Otrzymuje interakcję tekstową i definicje zachowań zapisane zwykłym językiem, po czym zwraca trzy prawdopodobieństwa dla każdej definicji: obecne, nieobecne i niemożliwe do zaobserwowania. Użytecznym wynikiem profilu jest rekord zachowania z jawną niepewnością, a nie pisemna odpowiedź na rozmowę.
Wybierz obserwację i jej granice
Zdefiniuj zachowanie słowami pasującymi do zadania. Przy sprawdzaniu przekazania do człowieka określ, czy chodzi o wyraźną prośbę użytkownika o osobę, stwierdzenie asystenta, że przekazanie jest potrzebne, czy dowolny z tych warunków. Jeśli samo rozczarowanie nie powinno się liczyć, powiedz to. Przy sprawdzaniu przeprosin określ, jakie sformułowanie stanowi przeprosiny, zamiast polegać na niejasnej etykiecie. Każda definicja ma identyfikator, który moduł oceniający zwraca wraz z jej prawdopodobieństwami.
Zestaw zachowań należy do wywołującego. Przykłady takie jak frustracja, nieuzasadnione obietnice, niewłaściwe użycie narzędzi lub powtarzające się działania agenta są definicjami do podania, a nie stałą listą natywnych kategorii. Każda definicja powinna być obserwowalna w dostarczonej interakcji. Krótki fragment może rozstrzygnąć, czy asystent przeprosił, jednocześnie nie zawierając dowodu, że zewnętrzny problem został rzeczywiście rozwiązany.
Przygotuj fragment rozmowy
Udokumentowane wejście Respan umieszcza wcześniejsze wiadomości w span.input, a ocenianą turę w span.output. Treść wiadomości jest ciągiem znaków. Zachowaj kontekst potrzebny do zrozumienia tury, w tym role rozmówców, istotną prośbę użytkownika i wszelki materiał tekstowy wykorzystany przez asystenta. Przy kontroli jakości podaj rzeczywistą turę, a nie parafrazę usuwającą oceniane zachowanie.
Przykładowy przegląd może obejmować wiadomość użytkownika opisującą powtarzające się trudności i odpowiedź asystenta oferującego zbadanie sprawy. Zdefiniuj frustrację użytkownika i obietnicę asystenta jako osobne obserwacje. Jeśli wynik narzędzia ma znaczenie dla oceny, czy twierdzenie było oparte na materiale, zachowaj w kontekście istotny tekst tego wyniku. Wyjście ocenia te definicje w dostarczonym fragmencie; model nie przeprowadza obiecanego badania ani nie zmienia samej rozmowy.
Obecne, nieobecne i niemożliwe do zaobserwowania
Odpowiedź oceniająca zawiera id zachowania oraz p_present, p_absent i p_not_observable, których suma wynosi w przybliżeniu 1. Brak możliwości obserwacji oznacza, że ślad nie pozwala odpowiedzieć na pytanie. Jest to coś innego niż nieobecność. Dla definicji takiej jak akceptacja rozwiązania przez klienta fragment kończący się przed reakcją klienta stanowi niepełny materiał, nawet jeśli odpowiedź asystenta brzmi pewnie.
Zachowaj wszystkie trzy wartości podczas przygotowywania wyniku do przeglądu. Kategoria wybrana na podstawie najwyższej wartości może przydać się do wyświetlania, ale rozkład zachowuje informację o niepewności obserwacji. Nie używaj samej niskiej wartości obecności, by wnioskować, że zachowanie na pewno nie wystąpiło. Gdy dominuje brak materiału, użytecznym działaniem może być uzyskanie odpowiedniego kontekstu lub zachowanie wyniku jako nieznanego zamiast wymyślania wyjaśnienia.
Kilka definicji na tym samym materiale
Proces oceniania producenta wspólnie ocenia wiele definicji zachowań na jednym śladzie i zwraca wynik dla każdego identyfikatora w kolejności żądania. Dokumentacja nie określa limitu liczby zachowań w pojedynczym żądaniu. Nie ustanawia to uniwersalnego okna tokenów ani nieograniczonego rozmiaru śladu. Dbaj o celowość definicji i istotność materiału oraz zachowuj powiązanie każdego zwróconego wyniku z definicją, która go wytworzyła.
Wyniki zachowań są niezależnymi obserwacjami, a nie jedną odpowiedzią z wyborem wykluczającym inne. Frustracja, przeprosiny i proponowane przekazanie mogą być obecne w tej samej wymianie. Indywidualny rozkład trójdzielny każdego z nich ma znaczenie w ramach danej definicji; dodawanie wartości obecności różnych zachowań nie tworzy znormalizowanego rozkładu kategorii ani oceny według uporządkowanej rubryki.
Zachowaj wybrany profil z jego wynikami
Producent dokumentuje nazwy Lite i standardową ze wspólną postacią żądania i wyniku. Ten kontrakt pozwala przygotowywać ślady i interpretować prawdopodobieństwa zachowań dla każdego z nazwanych profili. Nie dowodzi, że Lite ma te same wagi, liczbę parametrów lub jakość co inne wydanie. Zachowaj możliwość identyfikacji wybranego profilu podczas przeglądania jego wyników, zamiast po cichu wymieniać wyniki z różnych wydań.
Używaj oznaczonych rozmów z docelowego zadania, by wybierać progi rejestrowania, kierowania lub przeglądu. Zachowuj do analizy wyniki z wysokim prawdopodobieństwem braku możliwości obserwacji i obserwacje graniczne oraz porównuj każdy pozorny błąd z pierwotną turą i definicją zachowania. Użyteczny artefakt końcowy zawiera identyfikator fragmentu tekstu, definicję, wybrany profil i pełny trójdzielny wynik prawdopodobieństw. Późniejszy krok aplikacji decyduje, co zrobić z tą obserwacją; wyjście oceniające Lite samo nie wykonuje przekazania, nie blokuje odpowiedzi ani nie generuje naprawy.
Ailoot Ultra · System One POST /v1/systemone respan/span-01-lite
respan/span-01-liteStart
Span-01 Lite to osobno nazwany profil Respan do oceniania zachowań w rozmowach tekstowych i śladach działania agentów. Korzysta z zachowań zdefiniowanych przez wywołującego i zwraca dla każdego prawdopodobieństwa obecności, nieobecności i braku możliwości obserwacji, w tym samym udokumentowanym procesie oceniania co Span-01.
- 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-lite | 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 / 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 / 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-lite",
"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-lite'
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-lite
Aliasy ścieżek metod
Użyj ścieżek metod podanych powyżej.
Powiązane ID modeli
FAQ · Respan: Span-01 Lite
- Jakie dane wejściowe i wyniki są dostępne?
POST /v1/systemone·respan/span-01-lite:text→decisions- Jakich pól używa żądanie?
POST /v1/systemone·respan/span-01-lite:model,provider,questions,session_id,state,trace,user