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"