{"id":45761854,"url":"https://github.com/jeyroik/extas-alice","last_synced_at":"2026-02-25T23:18:43.660Z","repository":{"id":56998481,"uuid":"247901301","full_name":"jeyroik/extas-alice","owner":"jeyroik","description":"Extas package for Yandex.Alice skills development","archived":false,"fork":false,"pushed_at":"2022-11-30T16:06:30.000Z","size":38,"stargazers_count":6,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-09-26T20:58:27.612Z","etag":null,"topics":["extas","php","yandex-alice"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jeyroik.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-03-17T07:01:50.000Z","updated_at":"2023-06-26T10:44:10.000Z","dependencies_parsed_at":"2022-08-21T11:10:16.924Z","dependency_job_id":null,"html_url":"https://github.com/jeyroik/extas-alice","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/jeyroik/extas-alice","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeyroik%2Fextas-alice","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeyroik%2Fextas-alice/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeyroik%2Fextas-alice/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeyroik%2Fextas-alice/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jeyroik","download_url":"https://codeload.github.com/jeyroik/extas-alice/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeyroik%2Fextas-alice/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29844849,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-25T22:37:40.667Z","status":"ssl_error","status_checked_at":"2026-02-25T22:37:25.960Z","response_time":61,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["extas","php","yandex-alice"],"created_at":"2026-02-25T23:18:42.059Z","updated_at":"2026-02-25T23:18:43.648Z","avatar_url":"https://github.com/jeyroik.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Extas-alice\n\nБиблиотека для создания навыков для голосового помощника Алисы от компании Яндекс.\n\nДанная библиотека поддерживает сценарии (см. руководство ниже).\n\n# Установка\n\n`composer require jeyroik/extas-alice:1.*`\n\n# Использование\n\nПример использования библиотеки смотрите в репозитории [alice-extas-example](https://github.com/jeyroik/alice-extas-example \"Перейти к alice-extas-example\")\n\n## Реализация навыка\n\n- Регистрируем навык в Яндекс.Диалогах (https://dialogs.yandex.ru/developer/).\n- Получаем идентификатор навыка (skill_id).\n- Добавялем запись о навыке в extas.json в секцию skills:\n```json\n\"skills\": [\n  {\n    \"id\": \"идентификатор навыка, полученный в Яндекс.Диалогах\",\n    \"name\": \"алиас навыка, по нему будет организовываться связка со сценариями\",\n    \"description\": \"описание навыка, нигде не используется, заполняется только для понимания\"\n  }\n]\n```\n- Добавляем в extas.json шаги, которые потребуются для навыка:\n```json\n\"steps\": [\n  {\n    \"name\": \"Имя шага, по нему будут запускаться плагины (см. ниже)\",\n    \"title\": \"Название шага, используется только для понимания\",\n    \"description\": \"Описание шага, используется для понимания\"\n  }\n]\n```\n- Добавляем в extas.json сценарии навыка:\n```json\n\"scenarios\": [\n  {\n    \"name\": \"Имя сценария, используется для запуска плагинов\",\n    \"title\": \"Название сценария, используется для понимания\",\n    \"description\": \"Описание сценария, используется для понимания\",\n    \"skill_name\": \"алиас навыка - см. skills:name\",\n    \"schema\": {\n      \"message_1\": [{\n        \"condition\": \"имя класса для проверки условия, оставить пустым для обязателнього запуска данной реакции\",\n        \"step\": \"имя шага, см. steps:name\"\n      }],\n      \"message_x\": [{\n        \"condition\": \"\",\n        \"step\": \"demo.help\"\n      }, {\n        \"condition\": \"extas\\\\components\\\\yandex\\\\skills\\\\conditions\\\\ConditionTest\",\n        \"step\": \"demo.test\"\n      }]\n    }\n  }\n]\n```\n    - В схеме доступны два варианта идентификаторов сообщения: \n        - N, где N - целое число, идентификатор сообщения (см. детали https://yandex.ru/dev/dialogs/alice/doc/protocol-docpage/ описание по message_id)\n            - Пример: message_1, message_2\n        - x - для реакции на все сообщения пользователя;\n            - Пример: message_x\n-  При необходимости можно также заранее прописать карточки и кнопки (см. extas.json для примера).\n- Устанавливаем навык: `alice-extas# vendor/bin/extas i`\n- Запускаем навык: `alice-extas# php -S 0.0.0.0:8080 -t resources `\n    - См. `resources/index.php` для примера запуска. \n\n## Использование сценария\n\n- Сценарий состоит из реакций.\n- Реакция состоит из проверки условий и имени шага.\n- Шаг состоит из имени и описания.\n\nШаги можно установить предварительно.\n\n### Установка шагов\n\n```json\n{\n    \"steps\": [\n        {\n          \"name\": \"demo.help\",\n          \"title\": \"Помощь\",\n          \"description\": \"Пользователь запросил помощь\"\n        },\n        {\n          \"name\": \"demo.start\",\n          \"title\": \"Начало использования\",\n          \"description\": \"На этом шаге приветствуем пользователя\"\n        }\n      ]\n}\n```\n\nКак видно, шаги не зависят от сценария и могут переиспользоваться.\nПо каждому шагу запускается следующие стадии (события):\n- step.\u003cname шага\u003e\n- \u003cname сценария\u003e.step.\u003cname шага\u003e\n- \u003cname навыка\u003e.\u003cname сценария\u003e.step.\u003cname шага\u003e\n\nТаким образом возможно реализовать как общую логику (и ограничения), так и персонально для каждого сценария и навыка.\n\n### Установка сценария\n\n```json\n\"scenarios\": [\n    {\n      \"name\": \"demo\",\n      \"title\": \"Демонстрационный сценарий\",\n      \"description\": \"Это демонстрационный сценарий\",\n      \"skill_name\": \"test\",\n      \"schema\": {\n        \"message_1\": [{\n          \"condition\": \"\",\n          \"step\": \"demo.start\"\n        }],\n        \"message_x\": [{\n          \"condition\": \"\",\n          \"step\": \"demo.help\"\n        }]\n      }\n    }\n  ]\n```\n\nСхема сценария может содержать следующие секции:\n\n- `message_N`, где `N` - любое целое число, представляющее идентификатор сообщения (см. документацию по навыкам). Данная секция содержит реакции на конкретное по порядку сообщение.\n- `message_x` - данная секция содержит реакции для вариативных по порядку сообщений.\n\nКаждая реакция состоит из\n- `condition` - проверка условия. Если данная реакция должна применяться всегда, поле оставляется пустым, в противном случае здесь указывается имя класса. Класс реакции должен реализовывать метод `__invoke(IAliceCall $call)` и возвращать `bool` (`true` или `false`). Если `true`, то будет запущен соответствующий реакции шаг.\n- `step` - имя шага, который нужно запустить, если условия подходят.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeyroik%2Fextas-alice","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjeyroik%2Fextas-alice","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeyroik%2Fextas-alice/lists"}