К содержимому

Первая сессия через API ​

Создание сессии сразу принимает первую задачу. Профиль default и шаблон codex должны быть настроены на сервере.

json
{
  "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 из конфигурации сервера и отправьте запрос:

sh
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 хранится в истории, но не передаётся агенту. Если агенту нужен номер тикета, укажите его также в тексте или инструкции.

Метод создания сессии · Получение результата