API персонального AI-ассистента Online
Ваш собственный AI-ассистент, отвечающий на основе ВАШЕГО контента и НАШИХ живых данных о границе. Дайте нам свои markdown-файлы или просто укажите страницы — мы заберём их сами и проиндексируем. Выберите, какие наши данные он может использовать (очереди, прогноз, альтернативные пункты, топливо, запреты для грузовиков, праздники, состояние дорог…), выберите уровень модели (именно он задаёт цену), напишите собственные инструкции с плейсхолдерами {{feed.slug}}, указывающими, где именно в ответе появятся наши данные, и добавьте собственное завершающее предложение, дописываемое к каждому ответу. Соберите и протестируйте ассистента на /{lang}/developers/studio, а затем вызывайте его отсюда. Цена одного ответа = юниты уровня модели + 1 юнит за каждый включённый источник (показано в студии и в заголовке X-Devapi-Units).
GET https://nakordoni.eu/api/v2/data/assistant-custom
— класс квоты: heavy
| Параметр | Описание |
|---|---|
assistant_id | Your assistant id from Developers → AI Studio (required) |
q | The end-user question, plain text, max 1000 chars (required) |
lang | Answer language code — overrides the assistant default (optional) |
ppid | Checkpoint context for queue/forecast/alternatives feeds, e.g. id_13 (optional) |
origin | Origin country code for the border feed (optional) |
destination | Destination country code for the border feed (optional) |
crossing_type | Vehicle type for border/alternatives feeds: 4=car, 6=bus, 8=truck (Freight Transport), 9=truck up to 7.5 t (optional) |
country | Country context for fuel / truck-bans / holidays / road-conditions feeds (optional) |
lat | Latitude for the POI feed (optional) |
lon | Longitude for the POI feed (optional) |
Поля ответа — внутри объекта data в конверте ответа. [] обозначает список, поэтому data.items[].name — это поле name каждого элемента. Поле бывает null, отсутствует или пустой список, если значения у нас нет, — заглушки мы не подставляем.
| Поле | Описание |
|---|---|
data.assistant_id | Which of your assistants answered, with assistant — its name. |
data.question | The question as asked, with lang. |
data.answer | The answer, grounded on your indexed content plus the feeds you enabled. |
data.model_tier | Model tier that ran — this is what sets the price, together with the feed count. |
data.sources | Your content chunks the answer drew on, so you can cite them. |
data.feeds | Our live feeds that were actually used in this answer. |
data.feeds_skipped | Feeds enabled on the assistant but skipped because the request lacked their context — each value names the parameters to pass next time. |
data.ms | How long the answer took to generate. |
curl "https://nakordoni.eu/api/v2/data/assistant-custom?assistant_id=1&q=Should I cross tonight or in the morning?&ppid=id_13&lang=uk" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Обновлено