Быстрый старт: коннектор Яндекс Express

Около получаса без агента: скачать пакет проверки, разложить рабочий образец, довести проверку до зелёной и собрать файл для владельца компании.

Нужны Node.js 22 или новее, curl и shasum (macOS и Linux). Каждая команда ниже — из пустой папки, без репозитория платформы и без переменных окружения. Тот же порядок прогоняет наш тест.

1. Пакет проверки

Скачайте пакет набора 4 и сверьте сумму: она должна сойтись до первого запуска.

mkdir -p yandex-express && cd yandex-express
curl -fsSLo dala-connector-kit.mjs https://www.zengi.ai/developers/kit/v4/dala-connector-kit.mjs
echo "3cb1762da27bf487594e413ec509d42ce3b8ddd158c543d659bc491147a358a8  dala-connector-kit.mjs" | shasum -a 256 -c -

2. Рабочий образец

Пакет печатает образец в форме файла публикации: манифест и кассеты. Разложите его по файлам — манифест рядом, кассеты по путям из contract_tests.

node dala-connector-kit.mjs sample yandex_express > sample.json
node -e 'const fs = require("fs"), path = require("path");
  const body = JSON.parse(fs.readFileSync("sample.json", "utf8"));
  fs.writeFileSync("manifest.json", JSON.stringify(body.manifest, null, 2));
  for (const [file, cassette] of Object.entries(body.cassettes)) {
    fs.mkdirSync(path.dirname(file), { recursive: true });
    fs.writeFileSync(file, JSON.stringify(cassette, null, 2));
  }'

3. Проверка

Код выхода 0 и строка ЗЕЛЁНЫЙ — проверка пройдена; 1 — красная, строки с ✖ называют, что править; 2 — неверный вызов.

node dala-connector-kit.mjs conformance manifest.json

4. Файл для владельца компании

При зелёной проверке пакет собирает файл публикации. В нём — манифест, кассеты и номер набора пакета.

node dala-connector-kit.mjs bundle manifest.json > connector.json

Отдайте connector.json владельцу компании: он загрузит его в «Интеграциях». Свою систему описывайте так же — по образцу, меняя операции и кассеты; на поля манифеста подскажут строки ✖ проверки.

Свой коннектор с агентом — команда «новый коннектор».

Эта страница в Markdown