Respan: Span-01 Lite
Span-01 Lite — отдельно именованный профиль Respan для оценки поведения в текстовых разговорах и трассах агентов. Он использует определения поведения от вызывающей стороны и возвращает для каждого вероятности присутствия, отсутствия и невозможности установить по наблюдению, следуя тому же документированному процессу оценки, что и Span-01.
О модели
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
Span-01 Lite — отдельно именованный профиль модели в семействе оценки поведения Span-01 от Respan. Краткое руководство и таблица моделей производителя указывают Lite как один из двух профилей с одинаковым процессом оценки. Он получает текстовое взаимодействие и определения поведения на обычном языке, затем возвращает три вероятности для каждого определения: присутствует, отсутствует и невозможно установить по наблюдению. Полезный вывод профиля — запись о поведении с явно выраженной неопределённостью, а не письменный ответ на разговор.
Выберите наблюдение и его границы
Определите поведение словами, соответствующими вашей задаче. Для проверки передачи человеку уточните, означает ли это прямую просьбу пользователя связать его с человеком, слова ассистента о необходимости передачи или любое из этих условий. Если простое разочарование не должно учитываться, укажите это. Для проверки извинения определите, какие формулировки считаются извинением, вместо опоры на неясную метку. Каждое определение имеет идентификатор, который оценщик возвращает вместе с вероятностями.
Набор видов поведения задаёт вызывающая сторона. Раздражение, неподтверждённые обещания, неправильное использование инструментов или повторяющиеся действия агента — примеры определений, которые нужно передать, а не фиксированный список нативных категорий. Каждое определение должно относиться к тому, что можно наблюдать в переданном взаимодействии. Короткий фрагмент может установить, извинился ли ассистент, но не содержать свидетельств фактического решения внешней проблемы.
Подготовьте фрагмент разговора
Документированный вход Respan помещает предшествующие сообщения в span.input, а оцениваемую реплику — в span.output. Содержимое сообщения является строкой. Сохраните контекст, необходимый для понимания реплики, включая роли говорящих, соответствующий запрос пользователя и текстовые свидетельства, использованные ассистентом. Для проверки качества предоставляйте реальную реплику, а не пересказ, устраняющий оцениваемое поведение.
Иллюстративная проверка может взять сообщение пользователя о повторяющейся проблеме и ответ ассистента с предложением разобраться. Определите раздражение пользователя и обещание ассистента как отдельные наблюдения. Если результат инструмента важен для оценки обоснованности утверждения, сохраните его относящийся к делу текст в контексте. Вывод оценивает эти определения в переданном фрагменте; модель не проводит обещанное расследование и не изменяет сам разговор.
Присутствует, отсутствует и невозможно установить по наблюдению
Ответ оценки содержит id поведения с p_present, p_absent и p_not_observable, сумма которых приблизительно равна 1. Невозможность установить по наблюдению означает, что трасса не позволяет ответить на вопрос. Это отличается от отсутствия. Для определения вроде принятия клиентом предложенного решения фрагмент, заканчивающийся до реакции клиента, является неполным свидетельством, даже если ответ ассистента звучит уверенно.
При подготовке результата к проверке сохраняйте все три значения. Категория, выбранная по наибольшему значению, может быть полезна для отображения, но распределение сохраняет степень неопределённости наблюдения. Не делайте вывод, что поведение точно не произошло, только по низкой вероятности присутствия. Когда преобладает нехватка свидетельств, полезным действием может быть получение нужного контекста или сохранение результата как неизвестного вместо выдумывания объяснения.
Несколько определений по одним свидетельствам
Процесс оценки производителя совместно оценивает несколько определений поведения по одной трассе и возвращает результат для каждого идентификатора в порядке запроса. Документация не задаёт ограничения количества видов поведения на запрос. Это не устанавливает универсальное токенное окно или неограниченный размер трассы. Делайте определения целенаправленными, а свидетельства релевантными и сохраняйте связь каждого возвращённого результата с породившим его определением.
Результаты поведения — независимые наблюдения, а не один ответ с взаимоисключающим выбором. Раздражение, извинение и предложение передачи человеку могут присутствовать в одном обмене сообщениями. Их отдельные трёхчастные распределения имеют смысл внутри каждого определения; сложение вероятностей присутствия разных видов поведения не создаёт нормализованного распределения категорий или упорядоченной оценки по шкале.
Сохраняйте выбранный профиль вместе с результатами
Производитель документирует имена Lite и стандартного профиля с общей формой запроса и результата. Этот контракт позволяет готовить трассы и интерпретировать вероятности поведения для любого из именованных профилей. Он не устанавливает, что у Lite те же веса, число параметров или качество, что у другого издания. При проверке результатов сохраняйте возможность идентифицировать выбранный профиль, вместо незаметной подмены результатов разных изданий.
Используйте размеченные разговоры из целевой задачи, чтобы выбирать пороги журналирования, маршрутизации или проверки. Сохраняйте результаты с высокой вероятностью невозможности установить по наблюдению и пограничные наблюдения для разбора, а любую кажущуюся ошибку сопоставляйте с исходной репликой и определением поведения. Полезный итоговый артефакт содержит идентификатор текстового фрагмента, определение, выбранный профиль и полный трёхчастный вероятностный результат. Последующий этап приложения решает, что делать с этим наблюдением; вывод оценки Lite сам не выполняет передачу человеку, не блокирует ответ и не создаёт исправление.
Ailoot Ultra · System One POST /v1/systemone respan/span-01-lite
respan/span-01-liteНачало
Span-01 Lite — отдельно именованный профиль Respan для оценки поведения в текстовых разговорах и трассах агентов. Он использует определения поведения от вызывающей стороны и возвращает для каждого вероятности присутствия, отсутствия и невозможности установить по наблюдению, следуя тому же документированному процессу оценки, что и Span-01.
- Допустимые входные данные
- Текст
- Результаты
- decisions
Доступно в Ailoot · входные данные и методы
Ailoot Ultra · System One POST /v1/systemone
- Входные данные
text- Результат
decisions- Выходной формат
- json
| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения respan/span-01-lite | По умолчанию— |
Полеprovider | Типschema | ТребованиеНеобязательно | Значения и ограничения | По умолчанию— |
Полеquestions | Типobject | ТребованиеОбязательно | Значения и ограничения | По умолчанию— |
Полеsession_id | Типstring | ТребованиеНеобязательно | Значения и ограничения | По умолчанию— |
Полеstate | Типschema | ТребованиеОбязательно | Значения и ограничения | По умолчанию— |
Полеtrace | Типschema | ТребованиеНеобязательно | Значения и ограничения | По умолчанию— |
Полеuser | Типstring | ТребованиеНеобязательно | Значения и ограничения | По умолчанию— |
Полеquestions.<id>.type | Типstring | ТребованиеОбязательно | Значения и ограничения noul, choice, score | По умолчанию— |
Полеquestions.<id>.instructions | Типstring|object|array | ТребованиеОбязательно | Значения и ограничения | По умолчанию— |
Полеquestions.<id>.criteria | Типobject|array | ТребованиеНеобязательно | Значения и ограничения Условия: choice/score: обязательны; noul: необязателен. criteria для choice — объект; для score — массив с minItems1. | По умолчанию— |
Полеquestions.<id>.criteria.true | Типstring|object|array | ТребованиеОбязательно | Значения и ограничения Применяется, когда: Передан объект критериев noul | По умолчанию— |
Полеquestions.<id>.criteria.false | Типstring|object|array | ТребованиеОбязательно | Значения и ограничения Применяется, когда: Передан объект критериев noul | По умолчанию— |
Сочетания входных материалов
noul · Обязательно: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Обязательно: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Обязательно: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Параметры и жизненный цикл метода
| Параметр | Контракт |
|---|---|
Параметрcontent_type | Контрактapplication/json |
Параметрrequired | Контрактmodel, state, questions |
Параметрmaterial_types | Контрактtext |
Параметрoptional_controls | Контрактprovider, session_id, trace, user |
Параметрmultimodal_input_binding | Контрактnull |
Жизненный цикл: synchronous
Передайте точный ID модели и сохраните полный нативный ответ.
Тарифы
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
- Быстрый режим
- Не указано При выборе быстрого режима
- Режим flex
- Не указано При выборе режима flex
- Максимальная интенсивность рассуждений
- Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)
Ставки Ailoot
Цены по конфигурациям
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Шкала ставок | Токенов контекста больше | Токенов контекста не более, включительно | Плата |
|---|---|---|---|---|
| КонфигурацияБазовые ставки за токены | Шкала ставокБазовая ставка | Токенов контекста больше— | Токенов контекста не более, включительноБез верхней границы | Плата Вход · Входные токены $0 / 1K токенов Выход · Выходные токены $0 / 1K токенов Вход · Чтение кэша — / 1K токенов Вход · Запись в кэш — / 1K токенов Вход · Запись в кэш, 1 час — / 1K токенов |
| КонфигурацияУровень 1 по длине запроса | Шкала ставок— | Токенов контекста больше0 | Токенов контекста не более, включительноБез верхней границы | Плата Вход · Входные токены $0 / 1K токенов Выход · Выходные токены $0 / 1K токенов Вход · Чтение кэша — / 1K токенов Вход · Запись в кэш — / 1K токенов Вход · Запись в кэш, 1 час — / 1K токенов |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
Примеры запросов
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
Получить и сохранить результаты
Ailoot Ultra · System One
json
Сохраняйте все готовые результаты
Сохраняйте каждый полностью полученный ответ, файл и элемент содержимого.
Сохраняется каждый предоставленный ответ с ID вопроса, его точным типом, значением noul/choice/score, уверенностью, вероятностями и легендой. Весь исходный JSON сохраняется и возвращается только после окончательного расчёта.
Если нужно проверить исходный ответ
Сохраните исходную операцию и полный либо частичный ответ; не повторяйте POST.
Поля ответа
| Поле | Тип |
|---|---|
Полеmodel | Типstring |
Полеid | Типstring |
Полеprovider | Типstring |
Полеanswers.<id>.type | Типstring |
Полеanswers.<id>.noul | Типnumber |
Полеanswers.<id>.choice | Типstring |
Полеanswers.<id>.score | Типnumber |
Полеanswers.<id>.confidence | Типnumber |
Полеanswers.<id>.probabilities | Типobject |
Полеanswers.<id>.legend | Типobject |
Полеusage.input_tokens | Типinteger |
Полеusage.output_tokens | Типinteger |
Полеusage.cost | Типnumber |
Ошибки и дальнейшие шаги
| Ответ | Условие | Следующий шаг |
|---|---|---|
Ответ400 · invalid_request_error | УсловиеНедопустимое обязательное поле, представление или значение | Следующий шагИсправьте указанное поле запроса. |
Псевдонимы
Псевдонимы моделей
Ailoot Ultra respan/span-01-lite
Псевдонимы путей метода
Используйте пути методов, указанные выше.
Связанные ID для вызова
FAQ · Respan: Span-01 Lite
- Какие входные данные и результаты доступны?
POST /v1/systemone·respan/span-01-lite:text→decisions- Какие поля использует запрос?
POST /v1/systemone·respan/span-01-lite:model,provider,questions,session_id,state,trace,user