Первая сессия через API
Создание сессии сразу принимает первую задачу. Профиль default и шаблон codex должны быть настроены на сервере.
{
"namespace": "helpdesk",
"external_key": "support.example.com:ticket:4821",
"configuration": {
"agent": {
"profile": "default",
"instructions": "Help the support operator. Explain the likely cause and suggest a reply."
},
"sandbox": {
"template": "codex"
}
},
"messages": [
{
"text": "Ticket 4821: the customer cannot export a report. Ask for the error message.",
"external_key": "support.example.com:event:105",
"metadata": {
"ticket_id": 4821,
"event_id": 105
}
}
]
}Здесь используется режим по умолчанию: allow_multiple_runs: false. Для простого коннектора достаточно новой сессии на каждую задачу. Для диалога с продолжением задайте true при создании сессии. Режим существующей сессии изменить нельзя.
Сохраните этот JSON как request.json. Задайте в окружении ORPHEUS_API_KEY из конфигурации сервера и отправьте запрос:
curl --fail-with-body http://localhost:8000/api/v1/sessions \
-H "Authorization: Bearer $ORPHEUS_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: helpdesk:ticket:4821:event:105' \
--data-binary @request.jsonОтвет 202 Accepted содержит session_id, run_id и message_id. Это подтверждение приёма, результат работы появится позже. Сохраните идентификаторы в своей системе.
namespace объединяет сессии интеграции. external_key связывает сессию с тикетом, но не запрещает создание нескольких сессий для одного тикета. Для повторов используйте Idempotency-Key.
Текст задачи находится в messages[].text. metadata хранится в истории, но не передаётся агенту. Если агенту нужен номер тикета, укажите его также в тексте или инструкции.