> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/expert-center/ru/vehicle-telematics-technology/can-and-obdii/obd-tracker-fundamentals.md).

# Основы OBD-устройств

OBD-устройства с поддержкой подключения без дополнительной настройки подключаются к диагностическому разъему транспортного средства, чтобы считывать данные двигателя без дополнительной проводки. Рассматриваются типы данных и сценарии использования для управления транспортом.

В этом руководстве вы узнаете, что такое OBD-устройство, как работают эти устройства и что делает их подходящими для автопарков, малого бизнеса и других пользователей.

Поставщики услуг мониторинга имеют ряд вариантов, которые стоит рассмотреть при выборе GPS-устройства. OBD-устройства (также называемые OBD2 или OBDII) — это доступный, удобный и доступный вариант для разных пользователей. Эти устройства по принципу «подключи и работай» просты в установке и предоставляют автопаркам богатые данные о транспортных средствах, помогая им использовать преимущества интеллектуальной телематики.

В этом документе мы объясним, как работают эти устройства, какие функции они предоставляют и как их используют. Navixy поддерживает OBD-устройства от множества производителей, и за более чем 15 лет опыта и сотни партнеров по всему миру мы накопили значительные знания в области телематики и управления транспортом.

![Расположение OBD-порта](https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-b15d8811f03bd67aac5c911fbcb20d370d8e258f%2Fobdii-connector-location-2.png?alt=media\&token=71aa6f81-e12f-49ce-85ad-c337bffb51cc)

OBD-порты обычно находятся в заштрихованной области

## Где можно использовать OBD-устройства?

Как уже было сказано, OBD-устройство — это любое GPS-устройство слежения, которое подключается к порту OBDII (бортовой диагностики) транспортного средства. Практически каждый легковой автомобиль, продаваемый с 1996 года, оснащен этим стандартным портом, что означает совместимость этих устройств почти со всеми автомобилями, грузовиками, внедорожниками и фургонами. Помимо определения местоположения по GPS, они также могут предоставлять автопаркам доступ к ценным данным о транспортном средстве, кодам DTC, DPA (анализу моделей вождения) и VIN.

![Пример OBD-устройства](https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-57e1537608ef9062d860c144c07138923490d695%2Fdevice-tracker.png?alt=media\&token=44fd2c5f-d7a8-4ec2-ac56-cfe7a9adfc47)

Пример OBD-устройства

## Что такое стандарт OBD?

Стандарт OBD изначально был разработан для улучшения норм контроля выбросов. Хотя самая ранняя версия технологии была представлена Volkswagen в 1960-х годах, стандарт OBDII начал становиться обязательным в разных странах в середине 1990-х годов и с тех пор распространился на большую часть мира.

Наряду с типом диагностического разъема и его распиновкой стандарт OBDII также определяет доступные протоколы электрических сигналов и формат сообщений, а также то, какие параметры транспортного средства следует контролировать и как кодировать эти данные.

OBD-порт также обычно доступен в электромобилях, хотя некоторые производители в будущем рассматривают возможность его замены, отчасти потому, что контроль выбросов неприменим к электромобилям.

## Распиновка

Распиновка OBDII включает 16 контактов, каждый из которых связывается с определенным протоколом. Хотя некоторые контакты стандартизированы, другие являются опциональными, например предназначенные для конкретного производителя или поставщика. В таблице ниже описан соответствующий протокол для каждого контакта. Примечание: Любой контакт без обозначения доступен для использования OEM-производителями.

![Распиновка OBDII](https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-bc52ce16f86ff1b55797f87e5232a892ca4462b2%2Fobd11-graphic.png?alt=media\&token=4156e378-d368-4256-a3cd-3bcfb3325244)

Распиновка OBDII

### Высокий/низкий CAN

Линии высокого и низкого уровня CAN-шины передают данные транспортного средства устройству. В режиме простоя на обеих линиях поддерживается напряжение 2,5 В. Однако поскольку для связи требуется разность напряжений, на высокой линии оно поднимается до 3,75 В, а на низкой опускается до 1,25 В, чтобы при передаче данных создавать разность 2,5 В. Поэтому шина CAN — надежный выбор для сетевой связи в мобильных устройствах.

### Линия K

Прежде всего линия K используется для диагностики транспортных средств. Это был первоначальный протокол, используемый стандартом OBDII для этой цели, пока CAN-шина не стала обязательной в 2008 году. Сейчас он в основном используется в более старых автомобилях и на рынках с менее развитой технологией.

### J1850

Доступный в двух вариантах, J1850 — это еще один стандартизированный протокол, который с тех пор в основном был заменен более новой технологией. Первый вариант, с широтно-импульсной модуляцией (PWM), обычно встречается в более старых автомобилях Ford, тогда как переменная широтно-импульсная модуляция (VPM) используется в моделях General Motors.

### J1939

Хотя стандарт OBD охватывает легковые и малотоннажные транспортные средства, протокол SAE J1939 устанавливает стандарты того, как устройства обмениваются данными в тяжелых транспортных средствах. Однако, в отличие от OBDII, J1939 стандартизирован, поэтому все производители используют общий язык.

Ниже вы можете увидеть, чем отличаются число контактов и их расположение для этого протокола.

![Распиновка J1939](https://2371323805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-bdad729228b3718d9fa7bc59f7e9719eaa631bf1%2Fheavy-duty-vehicles-graph.png?alt=media\&token=c71d6634-c7a7-4b9b-9739-6ec61780fee3)

Распиновка J1939

### J1708

Один протокол, который встречается в J1939, но не в OBDII, — это J1708 (CAN 2 high/low). Хотя это еще один старый протокол, который с тех пор был заменен считыванием по CAN-шине, он все еще включен в J1939 для поддержки старых тяжелых грузовиков. Этот протокол способен передавать такие параметры, как уровень топлива, абсолютный расход топлива и моточасы.

## В чем разница между OBD-устройствами и устройствами с проводным подключением?

При выборе GPS-устройства люди могут выбирать между портативными и питаемыми устройствами. Хотя первым требуется внутренний аккумулятор и срок их службы ограничен, вторые получают питание от аккумулятора транспортного средства. Эта группа также может быть либо устройством с проводным подключением, либо OBD-устройством.

Основное различие между OBD GPS-устройством слежения и устройством с проводным подключением сводится к установке. Устройства с проводным подключением, как правило, требуют профессиональной установки, поскольку для питания их нужно подключать к аккумулятору автомобиля через блок предохранителей. В сравнении с этим OBD-устройство подключается напрямую к порту OBDII, а значит установку может за секунды выполнить любой человек. Именно поэтому устройства OBD2 часто называют устройствами по принципу «подключи и работай».

Помимо простоты установки OBD-трекеры также передают богатые данные о транспортном средстве, поскольку могут напрямую получать доступ к CAN-шине. Это позволяет страхованию, основанному на использовании, компаниям по прокату автомобилей и корпоративным автопаркам получать такую информацию, как моточасы и расход топлива.

Наконец, поскольку профессиональная установка не требуется, OBD-устройства в долгосрочной перспективе часто могут быть более доступными, чем другие устройства.

## Почему люди выбирают OBD-устройства вместо других устройств?

Есть несколько причин выбрать OBD-устройство вместо другого типа GPS-устройства, включая простоту установки и доступную стоимость. Помимо удобства, они также предоставляют доступ к широкому набору параметров данных о транспортном средстве.

Как уже было сказано выше, устройства OBD2 чрезвычайно просты в установке, что делает их подходящим выбором для клиентов, у которых нет опыта работы с GPS-устройствами или системой проводки автомобиля. В результате развертывание продвинутого телематического решения возможно для широкого круга конечных пользователей. Кроме того, поскольку профессиональная установка не требуется, OBD-устройства могут быть более доступным вариантом для малого бизнеса и автопарков.

Несмотря на простоту установки, OBD-трекеры по-прежнему передают полезные телеметрические данные, как и их аналоги с проводным подключением, включая местоположение автомобиля и скорость, историю актива, оповещения и многое другое. Именно поэтому их часто внедряют те, кому нужно удобное и доступное телематическое решение, например автопарки компаний, служебные автомобили подрядчиков, такси и даже личные автомобили.

## Распространенные возможности OBD-устройств

Хотя некоторые функции отличаются от устройства к устройству, поставщики GPS-мониторинга могут ожидать доступ к целому ряду возможностей OBD-устройств.

### GPS-мониторинг

Каждое распространенное OBD2-устройство на рынке передает [местоположение по GPS](https://navixy.com/en/asset-gps-tracking/). В зависимости от настроек устройства и сценария использования это может означать либо просто обновленные координаты GPS по запросу, либо отслеживание в реальном времени на карте.

Для обеспечения большей точности, а также более быстрого и надежного позиционирования современные OBD-устройства поддерживают передовые технологии, включая несколько сетей GNSS, Assisted GPS, LBS / идентификатор соты и повышенную чувствительность благодаря новым модулям GPS или двум ортогональным антеннам GPS внутри устройства.

### Информация CAN-шины

Одно из главных преимуществ OBD-устройства — его прямое подключение к данным CAN-шины. Это не только дает доступ к топливу, двигателю, охлаждающей жидкости, аккумулятору и другим параметрам, но и к идентификационному номеру транспортного средства (VIN), индикатору неисправности (MIL) и кодам DTC для диагностики. По сути, то, что водитель видит на приборной панели, может отправляться в облако, чтобы дополнительно улучшить [управление транспортом](https://navixy.com/en/fleet-management/) работу.

### Геозоны

Многие компании используют [геозоны](https://www.navixy.com/blog/improve-fleet-oversight-with-navixy-geofences/) для мониторинга активов и предотвращения неправомерного использования, например когда сотрудники используют транспортные средства для личных дел или в нерабочее время. Кроме того, функция «Несанкционированное перемещение (по координатам)» может определить, буксируют ли транспортное средство с места, когда зажигание выключено.

### Мониторинг поведения водителя

Многие автопарки заботятся о безопасности, поэтому OBD-устройства часто используют для улучшения поведения водителя за рулем. Например, многие из этих устройств могут обнаруживать случаи резкого торможения, которые менеджер автопарка может использовать как для мониторинга износа транспортного средства, так и для определения того, у каких водителей больше всего нарушений. Некоторые OBD-устройства даже способны отслеживать скорость и обнаруживать аварии для дополнительных оповещений.

Navixy [Качество вождения](https://navixy.com/docs/user/ru/guide/fleet-management/eco-driving.md) система предлагает настраиваемые параметры штрафов за превышение скорости и опасное вождение, чтобы помочь компаниям оценивать сотрудников по безопасности. Затем они могут определить, каким водителям и в каких областях требуется обучение.

### Опасное вождение

Чтобы помочь отслеживать поведение водителя, некоторые OBD-устройства включают гироскопы и акселерометры для обнаружения случаев опасного вождения, таких как резкое торможение и ускорение. Помимо оповещения менеджера или диспетчера через платформу, устройство также может подать звуковой сигнал, чтобы сообщить водителю о нарушении.

### Мониторинг скорости

Подобно оповещениям об опасном вождении, мониторинг скорости можно использовать для повышения безопасности водителя. Менеджеры могут установить пороговые значения скорости, при превышении которых срабатывает оповещение, чтобы они могли принять корректирующие меры. Поскольку OBD-устройство отслеживает обороты двигателя через CAN-шину, оно может обнаруживать всплески и сообщать о них менеджеру.

### Обнаружение аварий

Некоторые OBD-устройства также могут определять момент столкновения благодаря наличию акселерометра или G-датчика.

### Мониторинг топлива

Чрезмерный [расход топлива](https://www.navixy.com/blog/remote-fuel-level-monitoring/) — один из самых распространенных способов, которыми автопарки теряют деньги. Устройства OBDII делают отслеживание и мониторинг уровней топлива простым и удобным, чтобы компании могли выявлять проблемы, связанные с перерасходом топлива, такие как частая работа двигателя на холостом ходу, утечки, кражи и другие проблемы.

### Уровень топлива

OBD-устройства могут взаимодействовать с оборудованием, которое контролирует [уровни топлива](https://navixy.com/docs/expert-center/ru/vehicle-telematics-technology/fuel-management/installation-and-initial-configuration-of-fuel-control-devices/fuel-level-sensors.md), включая емкостные, резистивные и другие датчики. Резкое изменение уровня может указывать на возможную кражу, давая компании больше времени на принятие мер.

### Расход топлива

Помимо выявления краж и утечек мониторинг топлива также может дать представление об эффективности автопарка путем отслеживания расхода топлива. Компании могут отслеживать неэффективность, связав эту функцию с оповещением о чрезмерной работе на холостом ходу, чтобы определить, какие транспортные средства расходуют больше всего топлива.

### События, связанные с топливом

Как уже упоминалось, OBD-устройства могут отслеживать несколько событий, связанных с топливом. Наряду с попытками кражи и чрезмерной работой двигателя на холостом ходу можно обнаружить опасное ускорение — еще одну распространенную причину перерасхода топлива.

### Идентификатор водителя

Автопарки любого размера часто выбирают защиту своих транспортных средств, требуя, чтобы водители предъявляли удостоверение личности перед запуском двигателя. Без правильной кнопки, ключа или тега транспортное средство не включится, что гарантирует, что уехать смогут только уполномоченные лица. Для поддержки этой функции некоторые OBD-устройства оснащены датчиками BLE для связи с Bluetooth-маяками.

### Bluetooth

[Bluetooth](https://navixy.com/docs/user/ru/guide/devices-and-settings/device-specific-controls/external-sensors/bluetooth-sensors.md) поддержка соединяет OBD-устройства с множеством вспомогательных устройств. Помимо идентификатора водителя, BLE-маяки могут включать датчики температуры, статус открытия/закрытия дверей и мониторы давления в шинах, и это лишь несколько примеров. Сочетание этих беспроводных устройств с удобством OBD2-устройства означает наличие надежной телематической системы без дорогостоящей или сложной установки.

### Голосовой мониторинг

Даже базовые OBD-трекеры часто предоставляют технологию голосового мониторинга через управление по SMS. После отправки сообщения на устройство человек может слышать, что происходит в автомобиле, через блок. Таким образом можно проверить водителя, который может оказаться в опасности.

## Распространенные применения OBD-устройств

OBD-устройства используются в значительном количестве сценариев в разных отраслях, поэтому мы сосредоточимся на нескольких самых популярных применениях.

### Отслеживание в реальном времени / местоположение актива

Для многих пользователей возможность надежно отслеживать местоположение автомобиля — это необходимость. С помощью OBD-устройства легко точно знать, где в любой момент находятся ваши транспортные средства. В результате их можно использовать как в бизнес-целях, так и для личных нужд.

### Бизнес-использование

И малые, и крупные компании используют OBD-устройства для мониторинга и повышения производительности. Например, они могут видеть, где находятся сотрудники или подрядчики, и назначать задания в зависимости от их местоположения, а также точно отслеживать пробег для возмещения расходов, если для работы используется личный автомобиль. OBD-устройства также полезны для наблюдения за расходом топлива и выявления расточительных практик, таких как работа двигателя на холостом ходу.

### Личное использование

OBD-устройства легко использовать людям в своих собственных транспортных средствах. Родители, которые хотят убедиться, что подростки в безопасности, могут использовать OBD-устройство для отслеживания случаев опасного вождения, таких как превышение скорости и резкое торможение. Кроме того, их можно использовать для определения местоположения человека, если с ним не удается связаться в экстренной ситуации.

### Биллинг на основе использования

Для более точного выставления счетов многие компании переходят на [биллинг на основе использования](https://www.navixy.com/blog/how-usage-based-pricing-diversifies-iot-revenue-streams-for-telematics-companies/). Это может помочь обеспечить, чтобы с клиентов взималась плата только за объем использования конкретного актива. Например, компании с оплатой за поездку используют OBD-устройства, чтобы точно определить, сколько миль проехал клиент, а также сколько топлива было использовано и были ли какие-либо нарушения опасного вождения.

### Автопарки лизинга/аренды

Поскольку OBD-устройства легко устанавливаются в легковых автомобилях, компании по лизингу и прокату автомобилей часто используют их для отслеживания больших автопарков. Это дает им полный контроль над тем, какие транспортные средства используются, где они находятся и кто ими управляет.

### Мониторинг топлива

Чтобы помочь компаниям понять точное потребление топлива транспортным средством, устройства OBD2 обычно предлагают возможности мониторинга топлива. С помощью отчетов и оповещений менеджеры автопарков могут получить представление о том, что может вызывать чрезмерный расход, а также отслеживать возможную кражу топлива или утечки.

### Техобслуживание

Поддержание автопарка легковых автомобилей, грузовиков или фургонов в отличном состоянии требует постоянного внимания к [техобслуживанию](https://navixy.com/docs/user/ru/guide/fleet-management/maintenance.md). Поскольку OBD-устройства имеют доступ к данным CAN-шины, они могут передавать ключевую информацию, такую как давление в шинах, моточасы, обороты двигателя и многое другое. Это позволяет отслеживать, когда следует выполнять такие сервисные работы, как замена масла и перестановка шин. Поддерживая транспортные средства в лучшем состоянии, можно ожидать повышения надежности и снижения затрат на ремонт.

## Какие бывают разные типы OBD-устройств?

Хотя OBD-устройства имеют одинаковый общий дизайн и функцию, разные устройства могут отличаться тем, способны ли они на самом деле считывать данные OBDII, предназначены ли они для автомобилей или тяжелой техники и требуется ли им удлинительный кабель.

### Чтение данных OBD или нет

Некоторые пользователи могут не знать, что некоторые OBD-трекеры не могут считывать информацию о транспортном средстве через CAN-шину. Это означает, что вы не сможете просматривать уровни топлива, события вождения, данные двигателя и многое другое. Однако если вам не нужна эта информация для ваших задач, то этот тип устройства все равно может подойти.

### Легковые или тяжелые транспортные средства

В то время как легковые транспортные средства, такие как автомобили, грузовики и фургоны, используют стандарт OBDII, более крупные транспортные средства и машины имеют другой протокол доступа к данным транспортного средства — J1939. В результате вам понадобится специальный тип адаптера и кабеля для OBDII-устройства. К счастью, поскольку эти машины по-прежнему имеют читаемые данные CAN-шины, вы сможете получить доступ ко всей информации, как и в обычном автомобиле или грузовике.

### Аксессуары для OBD

Помимо упомянутых выше адаптеров для J1939, OBD-устройства также могут поставляться с рядом других аксессуаров для поддержки своей работы. Например, если порт OBDII в вашем транспортном средстве находится в труднодоступном месте, вы можете использовать удлинительный кабель OBD, чтобы получить к нему доступ и надежно установить устройство. Кроме того, если вам нужно проводить тесты в контролируемых условиях, кабель питания OBD с гнездовым разъемом позволяет подключить устройство и выполнять диагностику там, где есть источник питания 10–30 В постоянного тока.

## Типичные характеристики OBD-устройств

В зависимости от применения вам важно знать физические характеристики рассматриваемого OBD-устройства, такие как его размер, вес и материал изготовления. В зависимости от применения вы также можете учитывать его степень защиты IP и срок службы аккумулятора.

### Размер

Хотя стандартного размера для OBD-устройства не существует, обычно они составляют примерно 50 x 50 x 25 мм или 2 x 2 x 1 дюйм.

Крайне важно, чтобы эти устройства были маленькими и незаметными. Это не только предотвращает их умышленное снятие, но и позволяет пользователям случайно не задеть и не сместить их. Кроме того, некоторые порты OBDII находятся в тесных местах, поэтому устройства должны быть достаточно малы, чтобы помещаться там, где они могут быть расположены.

### Вес

Подобно размерам OBD-устройств, эти устройства обычно весят в том же диапазоне — примерно от 40 до 70 граммов или от 1,4 до 2,5 унции.

### Степень защиты IP

Если OBD-устройство нужно использовать в отрасли со сложными условиями окружающей среды, например в горнодобыче или лесозаготовке, ему нужна соответствующая степень защиты IP. Эта степень описывает способность устройства выдерживать как воздействие воды, так и физических загрязнений, например пыли. Первая цифра обозначает стойкость к твердым частицам по шкале от 0 до 6, тогда как вторая оценивает водонепроницаемость по шкале от 0 до 9, где 0 означает отсутствие защиты.

Большинство OBD-устройств имеют степень защиты IP41, чего достаточно для большинства личных и деловых применений. Для большей устойчивости к влаге и грязи ищите OBD-устройство со степенью защиты IP67. Это может быть необходимо на карьере или в шахте, где пыль постоянно присутствует.

### Аккумулятор

Большинство OBD-устройств поставляются с источником питания и резервным аккумулятором, но обычно устройство получает питание от транспортного средства, когда зажигание включено. В результате их часто можно использовать в течение длительного времени, и емкость аккумулятора не является проблемой. Однако устройство продолжит потреблять немного энергии даже при выключенном зажигании, так что имейте это в виду для транспортных средств, которые могут простаивать неделями или месяцами.

## Недостатки использования OBD-устройства

Несмотря на множество преимуществ использования OBD-устройства, есть и несколько недостатков, которые следует учитывать. Обязательно помните об этих потенциальных проблемах при выборе GPS-устройства слежения.

### Легко украсть/снять

К сожалению, одно из главных преимуществ OBD-устройства — простота установки — одновременно является и недостатком. Поскольку устройство часто находится на виду, его легко просто снять, если человек не хочет, чтобы его отслеживали. Более того, человек может даже случайно задеть устройство, если оно находится в месте, где его легко ударить.

Чтобы предотвратить умышленное или случайное снятие устройства, OBD-устройство можно спрятать или убрать из виду с помощью удлинительного кабеля. Кроме того, многие OBD2-устройства имеют оповещения о снятии, поэтому если кто-то его отключит, на платформу будет отправлено оповещение.

### Разряжает аккумулятор автомобиля

Поскольку OBDII-трекеры получают питание от транспортного средства, они также берут его от аккумулятора. Естественно, многих беспокоит, что устройство разрядит аккумулятор, но, как правило, в краткосрочной перспективе это не так, поскольку большинство устройств переходят в режим сна с низким энергопотреблением, когда зажигание выключено. Однако, если срок службы аккумулятора транспортного средства вызывает беспокойство, вы можете проверить характеристики устройства, чтобы узнать о его энергопотреблении.

### Взлом данных

В последние годы было обнаружено, что несколько компаний используют OBDII-устройства, уязвимые к внешним атакам. При определенных условиях хакер потенциально может получить доступ к компьютеру автомобиля и приказать ему тормозить или ускоряться независимо от вашей команды. В основном это результат плохого администрирования системы, включая незашифрованные сети.

## Что такое сертификация и что она включает?

Документы сертификации GPS-устройства описывают, с какими операторами может работать устройство. Они также показывают, что устройство соответствует требованиям различных организаций, проводящих проверку здоровья и безопасности. В разных странах и регионах законы о соответствии различаются, поэтому важно, чтобы выбранное вами OBD-устройство было сертифицировано там, где вы живете. Полную сертификацию устройства вы можете уточнить у производителя.

## Поддерживаемые Navixy OBD-устройства

Узнайте больше о поддерживаемых нами OBD-устройствах, посетив нашу специальную страницу OBD-устройств.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/expert-center/ru/vehicle-telematics-technology/can-and-obdii/obd-tracker-fundamentals.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
