chore(i18n): refresh uk translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
eafdfcdf6b
commit
e1c858f608
@ -1,58 +1,74 @@
|
||||
---
|
||||
read_when:
|
||||
- Ви змінюєте вбудоване середовище виконання агента або реєстр обв’язок агента
|
||||
- Ви реєструєте обв’язку агента з вбудованого або довіреного Plugin
|
||||
- Вам потрібно зрозуміти, як Plugin Codex пов’язаний із постачальниками моделей
|
||||
- Ви змінюєте вбудоване середовище виконання агента або реєстр каркаса агента
|
||||
- Ви реєструєте каркас агента з комплектного або довіреного плагіна
|
||||
- Вам потрібно зрозуміти, як плагін Codex пов’язаний із постачальниками моделей
|
||||
sidebarTitle: Agent Harness
|
||||
summary: Експериментальна поверхня SDK для Plugin, які замінюють низькорівневий вбудований виконавець агента
|
||||
title: Plugin для обв’язки агента
|
||||
summary: Експериментальна поверхня SDK для плагінів, які замінюють низькорівневий вбудований виконавець агента
|
||||
title: Плагіни каркаса агента
|
||||
x-i18n:
|
||||
generated_at: "2026-04-25T20:40:01Z"
|
||||
generated_at: "2026-04-25T23:10:32Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 9742e8a1e5df64da939452b36767ccb01f25a388fd1307e9d75aeb73f5699947
|
||||
source_hash: 623d4d9b6bfe6f0746e2f72e8c221148f0aacc10f1d9de68e3ab9028d750ba34
|
||||
source_path: plugins/sdk-agent-harness.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
**Обв’язка агента** — це низькорівневий виконавець для одного підготовленого ходу агента OpenClaw. Це не постачальник моделей, не канал і не реєстр інструментів.
|
||||
Щоб зрозуміти користувацьку ментальну модель, див. [Середовища виконання агента](/uk/concepts/agent-runtimes).
|
||||
**Каркас агента** — це низькорівневий виконавець одного підготовленого ходу агента OpenClaw. Це не постачальник моделей, не канал і не реєстр інструментів.
|
||||
Опис моделі, орієнтованої на користувача, див. у [Середовища виконання агентів](/uk/concepts/agent-runtimes).
|
||||
|
||||
Використовуйте цю поверхню лише для вбудованих або довірених нативних Plugin. Контракт
|
||||
Використовуйте цю поверхню лише для комплектних або довірених нативних плагінів. Контракт
|
||||
досі є експериментальним, оскільки типи параметрів навмисно віддзеркалюють поточний
|
||||
вбудований виконавець.
|
||||
вбудований раннер.
|
||||
|
||||
## Коли використовувати обв’язку
|
||||
## Коли використовувати каркас
|
||||
|
||||
Реєструйте обв’язку агента, коли сімейство моделей має власне нативне середовище
|
||||
Реєструйте каркас агента, коли сімейство моделей має власне нативне середовище
|
||||
виконання сесії, а звичайний транспорт постачальника OpenClaw є хибною абстракцією.
|
||||
|
||||
Приклади:
|
||||
|
||||
- нативний сервер агента для кодування, який керує потоками та Compaction
|
||||
- локальний CLI або демон, який має передавати нативні події плану/міркування/інструментів у потоці
|
||||
- середовище виконання моделі, якому потрібен власний resume id на додачу до
|
||||
- нативний сервер агента для кодування, який керує потоками й Compaction
|
||||
- локальний CLI або демон, який має транслювати нативні події плану/міркування/інструментів
|
||||
- середовище виконання моделі, якому потрібен власний ідентифікатор відновлення на додачу до
|
||||
стенограми сесії OpenClaw
|
||||
|
||||
**Не** реєструйте обв’язку лише для того, щоб додати новий API LLM. Для звичайних HTTP або
|
||||
WebSocket API моделей створіть [Plugin постачальника](/uk/plugins/sdk-provider-plugins).
|
||||
**Не** реєструйте каркас лише для додавання нового API LLM. Для звичайних HTTP або
|
||||
WebSocket API моделей створіть [плагін постачальника](/uk/plugins/sdk-provider-plugins).
|
||||
|
||||
## Що все ще належить core
|
||||
|
||||
Перш ніж обв’язку буде вибрано, OpenClaw уже визначив:
|
||||
До вибору каркаса OpenClaw уже визначив:
|
||||
|
||||
- постачальника та модель
|
||||
- постачальника і модель
|
||||
- стан автентифікації середовища виконання
|
||||
- рівень міркування та бюджет контексту
|
||||
- файл стенограми/сесії OpenClaw
|
||||
- робочий простір, пісочницю та політику інструментів
|
||||
- зворотні виклики відповіді каналу та зворотні виклики потокової передачі
|
||||
- політику резервного перемикання моделі та перемикання live-моделей
|
||||
- робочу область, пісочницю та політику інструментів
|
||||
- зворотні виклики відповіді каналу та потокові зворотні виклики
|
||||
- політику резервного вибору моделі та перемикання живої моделі
|
||||
|
||||
Цей поділ є навмисним. Обв’язка виконує підготовлену спробу; вона не вибирає
|
||||
постачальників, не замінює доставку каналу й не перемикає моделі непомітно.
|
||||
Такий поділ є навмисним. Каркас виконує підготовлену спробу; він не вибирає
|
||||
постачальників, не замінює доставку через канал і не перемикає моделі непомітно.
|
||||
|
||||
## Зареєструйте обв’язку
|
||||
Підготовлена спроба також містить `params.runtimePlan` — набір політик під керуванням OpenClaw для рішень середовища виконання, які мають залишатися спільними між PI і нативними
|
||||
каркасами:
|
||||
|
||||
- `runtimePlan.tools.normalize(...)` і
|
||||
`runtimePlan.tools.logDiagnostics(...)` для політики схеми інструментів з урахуванням постачальника
|
||||
- `runtimePlan.transcript.resolvePolicy(...)` для санітизації стенограми та
|
||||
політики виправлення викликів інструментів
|
||||
- `runtimePlan.delivery.isSilentPayload(...)` для спільного `NO_REPLY` і
|
||||
приглушення доставки медіа
|
||||
- `runtimePlan.outcome.classifyRunResult(...)` для класифікації резервного вибору моделі
|
||||
- `runtimePlan.observability` для визначених метаданих постачальника/моделі/каркаса
|
||||
|
||||
Каркаси можуть використовувати план для рішень, які мають відповідати поведінці PI, але
|
||||
все одно повинні трактувати його як стан спроби, яким керує хост. Не змінюйте його і не використовуйте для
|
||||
перемикання постачальників/моделей у межах ходу.
|
||||
|
||||
## Зареєструвати каркас
|
||||
|
||||
**Імпорт:** `openclaw/plugin-sdk/agent-harness`
|
||||
|
||||
@ -90,112 +106,119 @@ export default definePluginEntry({
|
||||
|
||||
## Політика вибору
|
||||
|
||||
OpenClaw вибирає обв’язку після визначення постачальника/моделі:
|
||||
OpenClaw вибирає каркас після визначення постачальника/моделі:
|
||||
|
||||
1. Якщо для наявної сесії вже записано id обв’язки, він має пріоритет, тому зміни config/env не
|
||||
перемикають цю стенограму «на гарячу» на інше середовище виконання.
|
||||
2. `OPENCLAW_AGENT_RUNTIME=<id>` примусово задає зареєстровану обв’язку з цим id для
|
||||
1. Ідентифікатор каркаса, записаний у наявній сесії, має пріоритет, щоб зміни config/env не
|
||||
перемикали цю стенограму на інше середовище виконання на льоту.
|
||||
2. `OPENCLAW_AGENT_RUNTIME=<id>` примусово задає зареєстрований каркас з цим ідентифікатором для
|
||||
сесій, які ще не закріплені.
|
||||
3. `OPENCLAW_AGENT_RUNTIME=pi` примусово задає вбудовану обв’язку PI.
|
||||
4. `OPENCLAW_AGENT_RUNTIME=auto` просить зареєстровані обв’язки перевірити, чи підтримують вони
|
||||
3. `OPENCLAW_AGENT_RUNTIME=pi` примусово задає вбудований каркас PI.
|
||||
4. `OPENCLAW_AGENT_RUNTIME=auto` запитує зареєстровані каркаси, чи підтримують вони
|
||||
визначеного постачальника/модель.
|
||||
5. Якщо жодна зареєстрована обв’язка не підходить, OpenClaw використовує PI, якщо резервний перехід на PI не вимкнено.
|
||||
5. Якщо жоден зареєстрований каркас не підходить, OpenClaw використовує PI, якщо резервний PI
|
||||
не вимкнено.
|
||||
|
||||
Збої Plugin-обв’язок відображаються як збої виконання. У режимі `auto` резервний перехід на PI
|
||||
використовується лише тоді, коли жодна зареєстрована Plugin-обв’язка не підтримує визначеного
|
||||
постачальника/модель. Щойно Plugin-обв’язка заявила про запуск, OpenClaw не
|
||||
повторює той самий хід через PI, оскільки це може змінити семантику auth/runtime
|
||||
або продублювати побічні ефекти.
|
||||
Збої плагінових каркасів відображаються як збої виконання. У режимі `auto` резервний PI
|
||||
використовується лише тоді, коли жоден зареєстрований плагіновий каркас не підтримує визначеного
|
||||
постачальника/модель. Щойно плагіновий каркас заявив про запуск, OpenClaw не
|
||||
повторює цей самий хід через PI, оскільки це може змінити семантику автентифікації/середовища виконання
|
||||
або спричинити дублювання побічних ефектів.
|
||||
|
||||
Вибраний id обв’язки зберігається разом з id сесії після вбудованого запуску.
|
||||
Застарілі сесії, створені до появи закріплення обв’язок, вважаються закріпленими за PI, щойно вони
|
||||
мають історію стенограми. Використовуйте нову/скинуту сесію під час перемикання між PI та
|
||||
нативною Plugin-обв’язкою. `/status` показує id обв’язок, що не є типовими, наприклад `codex`,
|
||||
поруч із `Fast`; PI залишається прихованою, оскільки це типовий сумісний шлях.
|
||||
Якщо вибрана обв’язка видається несподіваною, увімкніть налагоджувальне логування `agents/harness` і
|
||||
перевірте структурований запис Gateway `agent harness selected`. Він містить
|
||||
вибраний id обв’язки, причину вибору, політику runtime/fallback, а в режимі
|
||||
`auto` — також результат підтримки для кожного кандидата Plugin.
|
||||
Ідентифікатор вибраного каркаса зберігається разом з ідентифікатором сесії після вбудованого запуску.
|
||||
Застарілі сесії, створені до закріплення каркасів, вважаються закріпленими за PI, щойно вони
|
||||
отримують історію стенограми. Під час перемикання між PI і нативним плагіновим каркасом використовуйте нову/скинуту сесію. `/status` показує ідентифікатори каркасів, відмінні від типових, наприклад `codex`,
|
||||
поруч із `Fast`; PI залишається прихованим, оскільки це типовий шлях сумісності.
|
||||
Якщо вибраний каркас виглядає неочікуваним, увімкніть журналювання налагодження `agents/harness` і
|
||||
перевірте структурований запис шлюзу `agent harness selected`. Він містить
|
||||
ідентифікатор вибраного каркаса, причину вибору, політику середовища виконання/резервного варіанта і, у
|
||||
режимі `auto`, результат підтримки для кожного плагінового кандидата.
|
||||
|
||||
Вбудований Plugin Codex реєструє `codex` як id своєї обв’язки. Core розглядає це
|
||||
як звичайний id Plugin-обв’язки; псевдоніми, специфічні для Codex, мають належати Plugin
|
||||
Комплектний плагін Codex реєструє `codex` як свій ідентифікатор каркаса. Core розглядає це
|
||||
як звичайний ідентифікатор плагінового каркаса; специфічні для Codex псевдоніми мають належати плагіну
|
||||
або config оператора, а не спільному селектору середовища виконання.
|
||||
|
||||
## Поєднання постачальника та обв’язки
|
||||
## Поєднання постачальника і каркаса
|
||||
|
||||
Більшість обв’язок також мають реєструвати постачальника. Постачальник робить посилання на моделі,
|
||||
стан auth, метадані моделей і вибір `/model` видимими для решти
|
||||
OpenClaw. Потім обв’язка заявляє цей постачальник у `supports(...)`.
|
||||
Більшість каркасів також мають реєструвати постачальника. Постачальник робить посилання на моделі,
|
||||
стан автентифікації, метадані моделі та вибір `/model` видимими для решти
|
||||
OpenClaw. Потім каркас заявляє цей постачальник у `supports(...)`.
|
||||
|
||||
Вбудований Plugin Codex дотримується цього шаблону:
|
||||
Комплектний плагін Codex дотримується цього шаблону:
|
||||
|
||||
- бажані користувацькі посилання на моделі: `openai/gpt-5.5` плюс
|
||||
- бажані посилання на моделі для користувача: `openai/gpt-5.5` плюс
|
||||
`embeddedHarness.runtime: "codex"`
|
||||
- посилання для сумісності: застарілі посилання `codex/gpt-*` залишаються підтримуваними, але нові
|
||||
config не повинні використовувати їх як звичайні посилання provider/model
|
||||
- id обв’язки: `codex`
|
||||
- auth: синтетична доступність постачальника, оскільки обв’язка Codex володіє
|
||||
- посилання сумісності: застарілі посилання `codex/gpt-*` залишаються підтримуваними, але нові
|
||||
config не повинні використовувати їх як звичайні посилання постачальника/моделі
|
||||
- ідентифікатор каркаса: `codex`
|
||||
- автентифікація: синтетична доступність постачальника, оскільки каркас Codex керує
|
||||
нативним входом/сесією Codex
|
||||
- запит до app-server: OpenClaw надсилає до Codex лише id моделі й дозволяє
|
||||
обв’язці взаємодіяти з нативним протоколом app-server
|
||||
- запит app-server: OpenClaw надсилає до Codex чистий ідентифікатор моделі й дозволяє
|
||||
каркасу працювати з нативним протоколом app-server
|
||||
|
||||
Plugin Codex є адитивним. Звичайні посилання `openai/gpt-*` і надалі використовують
|
||||
звичайний шлях постачальника OpenClaw, якщо ви не примусово задасте обв’язку Codex через
|
||||
Плагін Codex є адитивним. Звичайні посилання `openai/gpt-*` і далі використовують
|
||||
звичайний шлях постачальника OpenClaw, якщо ви не примусово задасте каркас Codex через
|
||||
`embeddedHarness.runtime: "codex"`. Старіші посилання `codex/gpt-*` і далі вибирають
|
||||
постачальника та обв’язку Codex для сумісності.
|
||||
постачальника і каркас Codex для сумісності.
|
||||
|
||||
Щодо налаштування оператором, прикладів префіксів моделей і конфігурацій лише для Codex див.
|
||||
[Обв’язка Codex](/uk/plugins/codex-harness).
|
||||
Налаштування оператора, приклади префіксів моделей і config лише для Codex див. у
|
||||
[Каркас Codex](/uk/plugins/codex-harness).
|
||||
|
||||
OpenClaw вимагає Codex app-server `0.125.0` або новіший. Plugin Codex перевіряє
|
||||
ініціалізаційний handshake app-server і блокує старіші або неверсіоновані сервери, щоб
|
||||
OpenClaw працював лише з тією поверхнею протоколу, з якою його було протестовано.
|
||||
Поріг `0.125.0` включає підтримку payload нативного гачка MCP, що з’явилася в
|
||||
Codex `0.124.0`, водночас прив’язуючи OpenClaw до новішої протестованої стабільної лінійки.
|
||||
OpenClaw вимагає Codex app-server `0.125.0` або новіший. Плагін Codex перевіряє
|
||||
ініціалізаційне рукостискання app-server і блокує старіші сервери або сервери без версії, щоб
|
||||
OpenClaw працював лише з поверхнею протоколу, з якою його було протестовано. Поріг
|
||||
`0.125.0` включає підтримку payload нативних гачків MCP, що з’явилася в
|
||||
Codex `0.124.0`, водночас фіксуючи OpenClaw на новішій протестованій стабільній гілці.
|
||||
|
||||
### Проміжне ПЗ результатів інструментів
|
||||
### Проміжне програмне забезпечення результатів інструментів
|
||||
|
||||
Вбудовані Plugin можуть підключати нейтральне до середовища виконання проміжне ПЗ результатів інструментів через
|
||||
Комплектні плагіни можуть підключати нейтральне до середовища виконання проміжне програмне забезпечення для результатів інструментів через
|
||||
`api.registerAgentToolResultMiddleware(...)`, коли їхній маніфест оголошує
|
||||
цільові id середовищ виконання в `contracts.agentToolResultMiddleware`. Цей довірений
|
||||
механізм призначено для асинхронних перетворень результатів інструментів, які мають виконуватися
|
||||
до того, як PI або Codex повернуть вихід інструмента назад у модель.
|
||||
цільові ідентифікатори середовищ виконання в `contracts.agentToolResultMiddleware`. Цей довірений
|
||||
шов призначений для асинхронних перетворень результатів інструментів, які мають виконуватися до того, як PI або Codex поверне
|
||||
вивід інструмента назад у модель.
|
||||
|
||||
Застарілі вбудовані Plugin усе ще можуть використовувати
|
||||
`api.registerCodexAppServerExtensionFactory(...)` для проміжного ПЗ лише для Codex app-server,
|
||||
але нові перетворення результатів мають використовувати API, нейтральний до середовища виконання.
|
||||
Гачок лише для Pi `api.registerEmbeddedExtensionFactory(...)` було вилучено;
|
||||
перетворення результатів інструментів Pi мають використовувати проміжне ПЗ, нейтральне до середовища виконання.
|
||||
Застарілі комплектні плагіни все ще можуть використовувати
|
||||
`api.registerCodexAppServerExtensionFactory(...)` для проміжного програмного забезпечення лише для app-server Codex,
|
||||
але нові перетворення результатів мають використовувати нейтральний до середовища виконання API.
|
||||
Гачок `api.registerEmbeddedExtensionFactory(...)`, що працював лише для Pi, було видалено;
|
||||
перетворення результатів інструментів у Pi мають використовувати нейтральне до середовища виконання проміжне програмне забезпечення.
|
||||
|
||||
### Режим нативної обв’язки Codex
|
||||
### Класифікація термінального результату
|
||||
|
||||
Вбудована обв’язка `codex` — це нативний режим Codex для вбудованих ходів
|
||||
агента OpenClaw. Спочатку ввімкніть вбудований Plugin `codex` і додайте `codex` до
|
||||
`plugins.allow`, якщо ваш config використовує обмежувальний список дозволених значень. Конфігурації нативного app-server
|
||||
мають використовувати `openai/gpt-*` з `embeddedHarness.runtime: "codex"`.
|
||||
Нативні каркаси, які керують власною проєкцією протоколу, можуть використовувати
|
||||
`classifyAgentHarnessTerminalOutcome(...)` з
|
||||
`openclaw/plugin-sdk/agent-harness-runtime`, коли завершений хід не створив
|
||||
видимого тексту помічника. Допоміжна функція повертає `empty`, `reasoning-only` або
|
||||
`planning-only`, щоб політика резервного вибору OpenClaw могла вирішити, чи варто повторити спробу на
|
||||
іншій моделі. Вона навмисно не класифікує помилки запиту, ходи в процесі виконання та
|
||||
навмисні беззвучні відповіді, як-от `NO_REPLY`.
|
||||
|
||||
### Режим нативного каркаса Codex
|
||||
|
||||
Комплектний каркас `codex` — це нативний режим Codex для вбудованих ходів агента
|
||||
OpenClaw. Спочатку ввімкніть комплектний плагін `codex` і додайте `codex` до
|
||||
`plugins.allow`, якщо у вашому config використовується обмежувальний allowlist. Нативні config app-server мають використовувати `openai/gpt-*` разом з
|
||||
`embeddedHarness.runtime: "codex"`.
|
||||
Натомість використовуйте `openai-codex/*` для OAuth Codex через PI. Застарілі посилання на моделі `codex/*`
|
||||
залишаються сумісними псевдонімами для нативної обв’язки.
|
||||
залишаються псевдонімами сумісності для нативного каркаса.
|
||||
|
||||
Коли цей режим працює, Codex керує нативним id потоку, поведінкою відновлення,
|
||||
Compaction і виконанням app-server. OpenClaw, як і раніше, керує каналом чату,
|
||||
видимим дзеркалом стенограми, політикою інструментів, схваленнями, доставкою медіа та
|
||||
вибором сесії. Використовуйте `embeddedHarness.runtime: "codex"` без перевизначення `fallback`,
|
||||
коли потрібно довести, що лише шлях app-server Codex може заявити про цей запуск.
|
||||
Явно задані Plugin runtime уже за замовчуванням завершуються з помилкою в закритому режимі. Встановлюйте `fallback: "pi"`
|
||||
лише тоді, коли ви свідомо хочете, щоб PI обробляла відсутній вибір обв’язки. Збої Codex
|
||||
app-server уже напряму завершуються помилкою замість повторної спроби через PI.
|
||||
Коли цей режим працює, Codex керує нативним ідентифікатором потоку, поведінкою відновлення,
|
||||
Compaction і виконанням app-server. OpenClaw як і раніше керує чатом каналу,
|
||||
видимим дзеркалом стенограми, політикою інструментів, погодженнями, доставкою медіа та вибором сесії. Використовуйте `embeddedHarness.runtime: "codex"` без перевизначення `fallback`,
|
||||
коли потрібно довести, що запуск може бути заявлений лише шляхом Codex app-server.
|
||||
Явно задані плагінові середовища виконання вже типово завершуються із закритою помилкою.
|
||||
Встановлюйте `fallback: "pi"` лише тоді, коли ви навмисно хочете, щоб PI обробляв відсутність вибору каркаса. Збої Codex app-server вже напряму завершуються помилкою замість повторної спроби через PI.
|
||||
|
||||
## Вимкнення резервного переходу на PI
|
||||
## Вимкнути резервний PI
|
||||
|
||||
За замовчуванням OpenClaw запускає вбудованих агентів із `agents.defaults.embeddedHarness`,
|
||||
встановленим у `{ runtime: "auto", fallback: "pi" }`. У режимі `auto` зареєстровані Plugin-обв’язки
|
||||
можуть заявити про пару постачальник/модель. Якщо жодна не підходить, OpenClaw повертається до PI.
|
||||
Типово OpenClaw запускає вбудованих агентів із `agents.defaults.embeddedHarness`,
|
||||
встановленим у `{ runtime: "auto", fallback: "pi" }`. У режимі `auto` зареєстровані плагінові
|
||||
каркаси можуть заявляти пару постачальник/модель. Якщо жоден не підходить, OpenClaw повертається до PI.
|
||||
|
||||
У режимі `auto` встановіть `fallback: "none"`, коли вам потрібно, щоб відсутність вибору Plugin-обв’язки
|
||||
призводила до помилки замість використання PI. Явно задані Plugin runtime, такі як
|
||||
`runtime: "codex"`, уже за замовчуванням завершуються з помилкою в закритому режимі, якщо лише `fallback: "pi"` не
|
||||
задано в тій самій області перевизначення config або середовища. Збої вибраних Plugin-обв’язок
|
||||
завжди завершуються жорсткою помилкою. Це не блокує явний `runtime: "pi"` або
|
||||
У режимі `auto` встановіть `fallback: "none"`, якщо вам потрібно, щоб відсутність вибору
|
||||
плагінового каркаса завершувалася помилкою замість використання PI. Явно задані плагінові середовища виконання, як-от
|
||||
`runtime: "codex"`, уже типово завершуються із закритою помилкою, якщо лише `fallback: "pi"` не
|
||||
встановлено в тому самому config або області перевизначення середовища. Збої вибраного плагінового каркаса завжди завершуються жорсткою помилкою. Це не блокує явний `runtime: "pi"` або
|
||||
`OPENCLAW_AGENT_RUNTIME=pi`.
|
||||
|
||||
Для вбудованих запусків лише з Codex:
|
||||
@ -213,9 +236,9 @@ app-server уже напряму завершуються помилкою за
|
||||
}
|
||||
```
|
||||
|
||||
Якщо ви хочете, щоб будь-яка зареєстрована Plugin-обв’язка могла заявити про відповідні моделі, але ніколи
|
||||
не хочете, щоб OpenClaw непомітно повертався до PI, залиште `runtime: "auto"` і вимкніть
|
||||
резервний перехід:
|
||||
Якщо ви хочете, щоб будь-який зареєстрований плагіновий каркас заявляв сумісні моделі, але ніколи
|
||||
не хочете, щоб OpenClaw непомітно повертався до PI, збережіть `runtime: "auto"` і вимкніть
|
||||
резервний варіант:
|
||||
|
||||
```json
|
||||
{
|
||||
@ -230,7 +253,7 @@ app-server уже напряму завершуються помилкою за
|
||||
}
|
||||
```
|
||||
|
||||
Перевизначення для окремого агента використовують ту саму форму:
|
||||
Перевизначення для окремих агентів використовують ту саму структуру:
|
||||
|
||||
```json
|
||||
{
|
||||
@ -256,8 +279,8 @@ app-server уже напряму завершуються помилкою за
|
||||
```
|
||||
|
||||
`OPENCLAW_AGENT_RUNTIME` і далі перевизначає налаштоване середовище виконання. Використовуйте
|
||||
`OPENCLAW_AGENT_HARNESS_FALLBACK=none`, щоб вимкнути резервний перехід на PI з
|
||||
середовища.
|
||||
`OPENCLAW_AGENT_HARNESS_FALLBACK=none`, щоб вимкнути резервний PI через
|
||||
середовище.
|
||||
|
||||
```bash
|
||||
OPENCLAW_AGENT_RUNTIME=codex \
|
||||
@ -265,53 +288,52 @@ OPENCLAW_AGENT_HARNESS_FALLBACK=none \
|
||||
openclaw gateway run
|
||||
```
|
||||
|
||||
Коли резервний перехід вимкнено, сесія завершується помилкою на ранньому етапі, якщо запитана обв’язка не
|
||||
зареєстрована, не підтримує визначеного постачальника/модель або завершується помилкою до
|
||||
створення побічних ефектів ходу. Це зроблено навмисно для розгортань лише з Codex і
|
||||
для live-тестів, які мають довести, що шлях app-server Codex справді використовується.
|
||||
Коли резервний варіант вимкнено, сесія завершується помилкою на ранньому етапі, якщо запитуваний каркас не
|
||||
зареєстровано, він не підтримує визначеного постачальника/модель або зазнає збою до
|
||||
створення побічних ефектів ходу. Це навмисно для розгортань лише з Codex і
|
||||
для live-тестів, які мають довести, що шлях Codex app-server справді використовується.
|
||||
|
||||
Це налаштування керує лише обв’язкою вбудованого агента. Воно не вимикає маршрутизацію
|
||||
зображень, відео, музики, TTS, PDF або інших моделей, специфічних для постачальника.
|
||||
Цей параметр керує лише каркасом вбудованого агента. Він не вимикає маршрутизацію
|
||||
залежних від постачальника моделей для зображень, відео, музики, TTS, PDF або інших типів.
|
||||
|
||||
## Нативні сесії та дзеркало стенограми
|
||||
|
||||
Обв’язка може зберігати нативний id сесії, id потоку або токен відновлення на боці демона.
|
||||
Явно пов’язуйте цю прив’язку із сесією OpenClaw і продовжуйте
|
||||
віддзеркалювати видимий користувачеві вихід асистента/інструментів у стенограму OpenClaw.
|
||||
Каркас може зберігати нативний ідентифікатор сесії, ідентифікатор потоку або токен відновлення на боці демона.
|
||||
Явно пов’язуйте таку прив’язку із сесією OpenClaw і продовжуйте
|
||||
дзеркалити видимий користувачу вивід помічника/інструментів у стенограму OpenClaw.
|
||||
|
||||
Стенограма OpenClaw залишається шаром сумісності для:
|
||||
|
||||
- видимої в каналі історії сесії
|
||||
- пошуку та індексації стенограми
|
||||
- повернення до вбудованої обв’язки PI на наступному ході
|
||||
- загальної поведінки `/new`, `/reset` і видалення сесії
|
||||
- повернення до вбудованого каркаса PI на пізнішому ході
|
||||
- узагальненої поведінки `/new`, `/reset` і видалення сесії
|
||||
|
||||
Якщо ваша обв’язка зберігає побічну прив’язку, реалізуйте `reset(...)`, щоб OpenClaw міг
|
||||
очистити її, коли пов’язану сесію OpenClaw скинуто.
|
||||
Якщо ваш каркас зберігає побічну прив’язку, реалізуйте `reset(...)`, щоб OpenClaw міг
|
||||
очистити її під час скидання пов’язаної сесії OpenClaw.
|
||||
|
||||
## Результати інструментів і медіа
|
||||
|
||||
Core формує список інструментів OpenClaw і передає його в підготовлену спробу.
|
||||
Коли обв’язка виконує динамічний виклик інструмента, повертайте результат інструмента через
|
||||
форму результату обв’язки замість того, щоб самостійно надсилати медіа в канал.
|
||||
Коли каркас виконує динамічний виклик інструмента, повертайте результат інструмента назад через
|
||||
форму результату каркаса замість того, щоб самостійно надсилати медіа в канал.
|
||||
|
||||
Це зберігає текст, зображення, відео, музику, TTS, схвалення та вихід інструментів обміну повідомленнями
|
||||
в тому самому шляху доставки, що й для запусків на основі PI.
|
||||
Це зберігає виводи тексту, зображень, відео, музики, TTS, погоджень і інструментів обміну повідомленнями
|
||||
на тому самому шляху доставки, що й для запусків на базі PI.
|
||||
|
||||
## Поточні обмеження
|
||||
|
||||
- Публічний шлях імпорту є загальним, але деякі псевдоніми типів спроб/результатів усе ще
|
||||
мають назви `Pi` для сумісності.
|
||||
- Установлення сторонніх обв’язок є експериментальним. Віддавайте перевагу Plugin постачальника,
|
||||
містять назви `Pi` для сумісності.
|
||||
- Встановлення сторонніх каркасів є експериментальним. Віддавайте перевагу плагінам постачальників,
|
||||
доки вам не знадобиться нативне середовище виконання сесії.
|
||||
- Перемикання обв’язок між ходами підтримується. Не перемикайте обв’язки посеред
|
||||
ходу після того, як уже почалися нативні інструменти, схвалення, текст асистента або
|
||||
- Перемикання каркасів між ходами підтримується. Не перемикайте каркаси посеред ходу після того, як уже почалися нативні інструменти, погодження, текст помічника або
|
||||
надсилання повідомлень.
|
||||
|
||||
## Пов’язане
|
||||
|
||||
- [Огляд SDK](/uk/plugins/sdk-overview)
|
||||
- [Допоміжні засоби середовища виконання](/uk/plugins/sdk-runtime)
|
||||
- [Plugin постачальника](/uk/plugins/sdk-provider-plugins)
|
||||
- [Обв’язка Codex](/uk/plugins/codex-harness)
|
||||
- [Плагіни постачальників](/uk/plugins/sdk-provider-plugins)
|
||||
- [Каркас Codex](/uk/plugins/codex-harness)
|
||||
- [Постачальники моделей](/uk/concepts/model-providers)
|
||||
|
||||
@ -2,33 +2,33 @@
|
||||
read_when:
|
||||
- Вибір правильного підшляху plugin-sdk для імпорту Plugin
|
||||
- Аудит підшляхів bundled-plugin і допоміжних поверхонь
|
||||
summary: 'Каталог підшляхів Plugin SDK: які імпорти де розміщені, згруповано за областями'
|
||||
summary: 'Каталог підшляхів Plugin SDK: які імпорти де знаходяться, згруповано за областями'
|
||||
title: Підшляхи Plugin SDK
|
||||
x-i18n:
|
||||
generated_at: "2026-04-25T21:24:49Z"
|
||||
generated_at: "2026-04-25T23:10:30Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 15fcedbb91b0b5c6ee79ee7f18c2b68867e3818b0d37e9870a1d2ef3f848f52a
|
||||
source_hash: 72997c3aa6459c1f94cdca1ef5ed4073bf972a451ed3eb0f9724b5ec86986c7c
|
||||
source_path: plugins/sdk-subpaths.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
Plugin SDK доступний як набір вузьких підшляхів у `openclaw/plugin-sdk/`.
|
||||
На цій сторінці наведено каталог найуживаніших підшляхів, згрупованих за призначенням. Згенерований
|
||||
повний список із понад 200 підшляхів розміщено в `scripts/lib/plugin-sdk-entrypoints.json`;
|
||||
зарезервовані допоміжні підшляхи bundled-plugin також наведено там, але вони є деталями
|
||||
реалізації, якщо тільки сторінка документації явно не просуває їх.
|
||||
Plugin SDK представлено як набір вузьких підшляхів у `openclaw/plugin-sdk/`.
|
||||
На цій сторінці наведено каталог найбільш уживаних підшляхів, згрупованих за призначенням. Згенерований
|
||||
повний список із понад 200 підшляхів міститься у `scripts/lib/plugin-sdk-entrypoints.json`;
|
||||
зарезервовані допоміжні підшляхи bundled-plugin також там присутні, але є
|
||||
деталями реалізації, якщо лише сторінка документації явно не просуває їх.
|
||||
|
||||
Щоб ознайомитися з посібником з розробки Plugin, див. [Огляд Plugin SDK](/uk/plugins/sdk-overview).
|
||||
Посібник з розробки Plugin див. у [Огляд Plugin SDK](/uk/plugins/sdk-overview).
|
||||
|
||||
## Точка входу Plugin
|
||||
|
||||
| Підшлях | Ключові експорти |
|
||||
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `plugin-sdk/plugin-entry` | `definePluginEntry` |
|
||||
| Підшлях | Ключові експорти |
|
||||
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `plugin-sdk/plugin-entry` | `definePluginEntry` |
|
||||
| `plugin-sdk/core` | `defineChannelPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase`, `defineSetupPluginEntry`, `buildChannelConfigSchema` |
|
||||
| `plugin-sdk/config-schema` | `OpenClawSchema` |
|
||||
| `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` |
|
||||
| `plugin-sdk/config-schema` | `OpenClawSchema` |
|
||||
| `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` |
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Підшляхи каналів">
|
||||
@ -37,183 +37,183 @@ x-i18n:
|
||||
| `plugin-sdk/channel-core` | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` |
|
||||
| `plugin-sdk/config-schema` | Експорт кореневої Zod-схеми `openclaw.json` (`OpenClawSchema`) |
|
||||
| `plugin-sdk/channel-setup` | `createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`, `createOptionalChannelSetupWizard`, а також `DEFAULT_ACCOUNT_ID`, `createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, `splitSetupEntries` |
|
||||
| `plugin-sdk/setup` | Спільні допоміжні функції майстра налаштування, підказки allowlist, побудовники статусу налаштування |
|
||||
| `plugin-sdk/setup` | Спільні допоміжні засоби майстра налаштування, запити allowlist, побудовники статусу налаштування |
|
||||
| `plugin-sdk/setup-runtime` | `createPatchedAccountSetupAdapter`, `createEnvPatchedAccountSetupAdapter`, `createSetupInputPresenceValidator`, `noteChannelLookupFailure`, `noteChannelLookupSummary`, `promptResolvedAllowFrom`, `splitSetupEntries`, `createAllowlistSetupWizardProxy`, `createDelegatedSetupWizardProxy` |
|
||||
| `plugin-sdk/setup-adapter-runtime` | `createEnvPatchedAccountSetupAdapter` |
|
||||
| `plugin-sdk/setup-tools` | `formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR` |
|
||||
| `plugin-sdk/account-core` | Допоміжні функції для конфігурації кількох облікових записів / action-gate, допоміжні функції fallback для облікового запису за замовчуванням |
|
||||
| `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, допоміжні функції нормалізації ідентифікатора облікового запису |
|
||||
| `plugin-sdk/account-resolution` | Допоміжні функції пошуку облікового запису + fallback до облікового запису за замовчуванням |
|
||||
| `plugin-sdk/account-helpers` | Вузькі допоміжні функції для списку облікових записів / дій з обліковими записами |
|
||||
| `plugin-sdk/account-core` | Допоміжні засоби багатoакаунтної конфігурації/контролю дій, допоміжні засоби резервного використання облікового запису за замовчуванням |
|
||||
| `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, допоміжні засоби нормалізації account-id |
|
||||
| `plugin-sdk/account-resolution` | Допоміжні засоби пошуку облікового запису та резервного використання значення за замовчуванням |
|
||||
| `plugin-sdk/account-helpers` | Вузькі допоміжні засоби для списку облікових записів/дій з обліковими записами |
|
||||
| `plugin-sdk/channel-pairing` | `createChannelPairingController` |
|
||||
| `plugin-sdk/channel-reply-pipeline` | `createChannelReplyPipeline` |
|
||||
| `plugin-sdk/channel-config-helpers` | `createHybridChannelConfigAdapter` |
|
||||
| `plugin-sdk/channel-config-schema` | Типи схеми конфігурації каналу |
|
||||
| `plugin-sdk/telegram-command-config` | Допоміжні функції нормалізації/валідації користувацьких команд Telegram із fallback до bundled-contract |
|
||||
| `plugin-sdk/command-gating` | Вузькі допоміжні функції шлюзу авторизації команд |
|
||||
| `plugin-sdk/telegram-command-config` | Допоміжні засоби нормалізації/валідації користувацьких команд Telegram із резервною підтримкою bundled-contract |
|
||||
| `plugin-sdk/command-gating` | Вузькі допоміжні засоби контролю авторизації команд |
|
||||
| `plugin-sdk/channel-policy` | `resolveChannelGroupRequireMention` |
|
||||
| `plugin-sdk/channel-lifecycle` | `createAccountStatusSink`, допоміжні функції життєвого циклу/фіналізації потоку чернеток |
|
||||
| `plugin-sdk/inbound-envelope` | Спільні допоміжні функції маршрутизації вхідних повідомлень + побудови конверта |
|
||||
| `plugin-sdk/inbound-reply-dispatch` | Спільні допоміжні функції запису й диспетчеризації вхідних відповідей |
|
||||
| `plugin-sdk/messaging-targets` | Допоміжні функції розбору/зіставлення цілей |
|
||||
| `plugin-sdk/outbound-media` | Спільні допоміжні функції завантаження вихідних медіа |
|
||||
| `plugin-sdk/outbound-send-deps` | Полегшений пошук залежностей вихідного надсилання для адаптерів каналів |
|
||||
| `plugin-sdk/outbound-runtime` | Допоміжні функції для вихідної доставки, ідентичності, делегата надсилання, сесії, форматування й планування payload |
|
||||
| `plugin-sdk/poll-runtime` | Вузькі допоміжні функції нормалізації опитувань |
|
||||
| `plugin-sdk/thread-bindings-runtime` | Допоміжні функції життєвого циклу прив’язок потоків і адаптера |
|
||||
| `plugin-sdk/agent-media-payload` | Застарілий побудовник медіа-payload агента |
|
||||
| `plugin-sdk/conversation-runtime` | Допоміжні функції прив’язки розмов/потоків, pairing і налаштованих прив’язок |
|
||||
| `plugin-sdk/runtime-config-snapshot` | Допоміжна функція знімка конфігурації середовища виконання |
|
||||
| `plugin-sdk/runtime-group-policy` | Допоміжні функції визначення групової політики середовища виконання |
|
||||
| `plugin-sdk/channel-status` | Спільні допоміжні функції знімка/підсумку статусу каналу |
|
||||
| `plugin-sdk/channel-lifecycle` | `createAccountStatusSink`, допоміжні засоби життєвого циклу/завершення чернетки потоку |
|
||||
| `plugin-sdk/inbound-envelope` | Спільні допоміжні засоби для маршруту вхідних повідомлень і побудови envelope |
|
||||
| `plugin-sdk/inbound-reply-dispatch` | Спільні допоміжні засоби запису та диспетчеризації вхідних відповідей |
|
||||
| `plugin-sdk/messaging-targets` | Допоміжні засоби розбору/зіставлення цілей |
|
||||
| `plugin-sdk/outbound-media` | Спільні допоміжні засоби завантаження вихідних медіа |
|
||||
| `plugin-sdk/outbound-send-deps` | Полегшений пошук залежностей надсилання вихідних повідомлень для адаптерів каналів |
|
||||
| `plugin-sdk/outbound-runtime` | Допоміжні засоби доставки вихідних повідомлень, ідентичності, делегата надсилання, сесії, форматування та планування payload |
|
||||
| `plugin-sdk/poll-runtime` | Вузькі допоміжні засоби нормалізації опитувань |
|
||||
| `plugin-sdk/thread-bindings-runtime` | Допоміжні засоби життєвого циклу прив’язок потоків і адаптерів |
|
||||
| `plugin-sdk/agent-media-payload` | Застарілий побудовник payload медіа агента |
|
||||
| `plugin-sdk/conversation-runtime` | Допоміжні засоби для розмови/прив’язки потоку, pairing і налаштованих прив’язок |
|
||||
| `plugin-sdk/runtime-config-snapshot` | Допоміжний засіб знімка конфігурації під час виконання |
|
||||
| `plugin-sdk/runtime-group-policy` | Допоміжні засоби визначення групової політики під час виконання |
|
||||
| `plugin-sdk/channel-status` | Спільні допоміжні засоби знімка/зведення стану каналу |
|
||||
| `plugin-sdk/channel-config-primitives` | Вузькі примітиви схеми конфігурації каналу |
|
||||
| `plugin-sdk/channel-config-writes` | Допоміжні функції авторизації запису конфігурації каналу |
|
||||
| `plugin-sdk/channel-plugin-common` | Спільні експорти prelude для Plugin каналу |
|
||||
| `plugin-sdk/allowlist-config-edit` | Допоміжні функції редагування/читання конфігурації allowlist |
|
||||
| `plugin-sdk/group-access` | Спільні допоміжні функції ухвалення рішень щодо групового доступу |
|
||||
| `plugin-sdk/direct-dm` | Спільні допоміжні функції автентифікації/захисту direct-DM |
|
||||
| `plugin-sdk/interactive-runtime` | Семантичне представлення повідомлень, доставка й застарілі допоміжні функції інтерактивних відповідей. Див. [Представлення повідомлень](/uk/plugins/message-presentation) |
|
||||
| `plugin-sdk/channel-inbound` | Сумісний barrel для debounce вхідних повідомлень, зіставлення згадок, допоміжних функцій політики згадок і допоміжних функцій конверта |
|
||||
| `plugin-sdk/channel-inbound-debounce` | Вузькі допоміжні функції debounce вхідних повідомлень |
|
||||
| `plugin-sdk/channel-mention-gating` | Вузькі допоміжні функції політики згадок і тексту згадок без ширшої поверхні середовища виконання вхідних повідомлень |
|
||||
| `plugin-sdk/channel-envelope` | Вузькі допоміжні функції форматування конверта вхідних повідомлень |
|
||||
| `plugin-sdk/channel-location` | Контекст розташування каналу й допоміжні функції форматування |
|
||||
| `plugin-sdk/channel-logging` | Допоміжні функції логування каналу для скидання вхідних повідомлень і збоїв typing/ack |
|
||||
| `plugin-sdk/channel-config-writes` | Допоміжні засоби авторизації запису конфігурації каналу |
|
||||
| `plugin-sdk/channel-plugin-common` | Спільні преамбулні експорти Plugin каналу |
|
||||
| `plugin-sdk/allowlist-config-edit` | Допоміжні засоби редагування/читання конфігурації allowlist |
|
||||
| `plugin-sdk/group-access` | Спільні допоміжні засоби ухвалення рішень щодо групового доступу |
|
||||
| `plugin-sdk/direct-dm` | Спільні допоміжні засоби автентифікації/захисту direct-DM |
|
||||
| `plugin-sdk/interactive-runtime` | Семантичне представлення повідомлень, доставка та застарілі допоміжні засоби інтерактивних відповідей. Див. [Представлення повідомлень](/uk/plugins/message-presentation) |
|
||||
| `plugin-sdk/channel-inbound` | Сумісний barrel для допоміжних засобів debounce вхідних повідомлень, зіставлення згадок, політики згадок та envelope |
|
||||
| `plugin-sdk/channel-inbound-debounce` | Вузькі допоміжні засоби debounce вхідних повідомлень |
|
||||
| `plugin-sdk/channel-mention-gating` | Вузькі допоміжні засоби політики згадок і тексту згадок без ширшої поверхні runtime вхідних повідомлень |
|
||||
| `plugin-sdk/channel-envelope` | Вузькі допоміжні засоби форматування envelope вхідних повідомлень |
|
||||
| `plugin-sdk/channel-location` | Допоміжні засоби контексту та форматування розташування каналу |
|
||||
| `plugin-sdk/channel-logging` | Допоміжні засоби журналювання каналу для відкинутих вхідних повідомлень і збоїв typing/ack |
|
||||
| `plugin-sdk/channel-send-result` | Типи результату відповіді |
|
||||
| `plugin-sdk/channel-actions` | Допоміжні функції дій із повідомленнями каналу, а також застарілі допоміжні функції native schema, що збережені для сумісності Plugin |
|
||||
| `plugin-sdk/channel-targets` | Допоміжні функції розбору/зіставлення цілей |
|
||||
| `plugin-sdk/channel-contract` | Типи контракту каналу |
|
||||
| `plugin-sdk/channel-actions` | Допоміжні засоби дій із повідомленнями каналу, а також застарілі нативні допоміжні засоби схем, збережені для сумісності Plugin |
|
||||
| `plugin-sdk/channel-targets` | Допоміжні засоби розбору/зіставлення цілей |
|
||||
| `plugin-sdk/channel-contract` | Типи контрактів каналу |
|
||||
| `plugin-sdk/channel-feedback` | Підключення feedback/reaction |
|
||||
| `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні функції secret-contract, такі як `collectSimpleChannelFieldAssignments`, `getChannelSurface`, `pushAssignment`, і типи цілей секретів |
|
||||
| `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні засоби secret-contract, такі як `collectSimpleChannelFieldAssignments`, `getChannelSurface`, `pushAssignment`, і типи цілей секретів |
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Підшляхи провайдерів">
|
||||
| Підшлях | Ключові експорти |
|
||||
| --- | --- |
|
||||
| `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` |
|
||||
| `plugin-sdk/provider-setup` | Кураторські допоміжні функції налаштування локального/self-hosted провайдера |
|
||||
| `plugin-sdk/self-hosted-provider-setup` | Сфокусовані допоміжні функції налаштування self-hosted провайдера, сумісного з OpenAI |
|
||||
| `plugin-sdk/cli-backend` | Значення CLI backend за замовчуванням + константи watchdog |
|
||||
| `plugin-sdk/provider-auth-runtime` | Допоміжні функції визначення API-ключа в середовищі виконання для Plugin провайдерів |
|
||||
| `plugin-sdk/provider-auth-api-key` | Допоміжні функції онбордингу API-ключів/запису профілів, такі як `upsertApiKeyProfile` |
|
||||
| `plugin-sdk/provider-setup` | Кураторські допоміжні засоби налаштування локальних/self-hosted провайдерів |
|
||||
| `plugin-sdk/self-hosted-provider-setup` | Сфокусовані допоміжні засоби налаштування self-hosted провайдерів, сумісних з OpenAI |
|
||||
| `plugin-sdk/cli-backend` | Значення за замовчуванням для бекенда CLI та константи watchdog |
|
||||
| `plugin-sdk/provider-auth-runtime` | Допоміжні засоби визначення API-ключа під час виконання для Plugin провайдерів |
|
||||
| `plugin-sdk/provider-auth-api-key` | Допоміжні засоби онбордингу/запису профілю API-ключа, такі як `upsertApiKeyProfile` |
|
||||
| `plugin-sdk/provider-auth-result` | Стандартний побудовник результату OAuth-автентифікації |
|
||||
| `plugin-sdk/provider-auth-login` | Спільні допоміжні функції інтерактивного входу для Plugin провайдерів |
|
||||
| `plugin-sdk/provider-env-vars` | Допоміжні функції пошуку змінних середовища для автентифікації провайдера |
|
||||
| `plugin-sdk/provider-auth-login` | Спільні допоміжні засоби інтерактивного входу для Plugin провайдерів |
|
||||
| `plugin-sdk/provider-env-vars` | Допоміжні засоби пошуку змінних середовища для автентифікації провайдера |
|
||||
| `plugin-sdk/provider-auth` | `createProviderApiKeyAuthMethod`, `ensureApiKeyFromOptionEnvOrPrompt`, `upsertAuthProfile`, `upsertApiKeyProfile`, `writeOAuthCredentials` |
|
||||
| `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні побудовники replay-policy, допоміжні функції endpoint провайдера й допоміжні функції нормалізації model-id, такі як `normalizeNativeXaiModelId` |
|
||||
| `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, спільні побудовники політики replay, допоміжні засоби endpoint провайдерів і допоміжні засоби нормалізації model-id, такі як `normalizeNativeXaiModelId` |
|
||||
| `plugin-sdk/provider-catalog-shared` | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` |
|
||||
| `plugin-sdk/provider-http` | Загальні допоміжні функції HTTP/endpoint-можливостей провайдера, помилки HTTP провайдера й допоміжні функції multipart form для аудіотранскрипції |
|
||||
| `plugin-sdk/provider-web-fetch-contract` | Вузькі допоміжні функції контракту конфігурації/вибору web-fetch, такі як `enablePluginInConfig` і `WebFetchProviderPlugin` |
|
||||
| `plugin-sdk/provider-web-fetch` | Допоміжні функції реєстрації/кешування провайдера web-fetch |
|
||||
| `plugin-sdk/provider-web-search-config-contract` | Вузькі допоміжні функції конфігурації/облікових даних web-search для провайдерів, яким не потрібне підключення ввімкнення Plugin |
|
||||
| `plugin-sdk/provider-web-search-contract` | Вузькі допоміжні функції контракту конфігурації/облікових даних web-search, такі як `createWebSearchProviderContractFields`, `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig`, а також scoped-сетери/гетери облікових даних |
|
||||
| `plugin-sdk/provider-web-search` | Допоміжні функції реєстрації/кешування/середовища виконання провайдера web-search |
|
||||
| `plugin-sdk/provider-tools` | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, очищення схеми Gemini + діагностика, а також допоміжні функції сумісності xAI, такі як `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
|
||||
| `plugin-sdk/provider-http` | Загальні допоміжні засоби можливостей HTTP/endpoint провайдерів, помилки HTTP провайдерів і допоміжні засоби multipart form для аудіотранскрипції |
|
||||
| `plugin-sdk/provider-web-fetch-contract` | Вузькі допоміжні засоби контрактів конфігурації/вибору web-fetch, такі як `enablePluginInConfig` і `WebFetchProviderPlugin` |
|
||||
| `plugin-sdk/provider-web-fetch` | Допоміжні засоби реєстрації/кешування провайдерів web-fetch |
|
||||
| `plugin-sdk/provider-web-search-config-contract` | Вузькі допоміжні засоби конфігурації/облікових даних web-search для провайдерів, яким не потрібне підключення ввімкнення Plugin |
|
||||
| `plugin-sdk/provider-web-search-contract` | Вузькі допоміжні засоби контрактів конфігурації/облікових даних web-search, такі як `createWebSearchProviderContractFields`, `enablePluginInConfig`, `resolveProviderWebSearchPluginConfig` і scoped setter/getter для облікових даних |
|
||||
| `plugin-sdk/provider-web-search` | Допоміжні засоби реєстрації/кешування/runtime для провайдерів web-search |
|
||||
| `plugin-sdk/provider-tools` | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, очищення схеми Gemini та діагностика, а також допоміжні засоби сумісності xAI, такі як `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
|
||||
| `plugin-sdk/provider-usage` | `fetchClaudeUsage` та подібні |
|
||||
| `plugin-sdk/provider-stream` | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, типи обгорток потоку й спільні допоміжні функції обгорток для Anthropic/Bedrock/DeepSeek V4/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
|
||||
| `plugin-sdk/provider-transport-runtime` | Допоміжні функції native transport провайдера, такі як guarded fetch, перетворення transport message і writable transport event streams |
|
||||
| `plugin-sdk/provider-onboard` | Допоміжні функції патчингу конфігурації онбордингу |
|
||||
| `plugin-sdk/global-singleton` | Допоміжні функції process-local singleton/map/cache |
|
||||
| `plugin-sdk/group-activation` | Вузькі допоміжні функції режиму активації групи й розбору команд |
|
||||
| `plugin-sdk/provider-stream` | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, типи обгорток потоків і спільні допоміжні засоби обгорток для Anthropic/Bedrock/DeepSeek V4/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
|
||||
| `plugin-sdk/provider-transport-runtime` | Нативні допоміжні засоби транспорту провайдерів, такі як guarded fetch, трансформації транспортних повідомлень і записувані потоки подій транспорту |
|
||||
| `plugin-sdk/provider-onboard` | Допоміжні засоби patch конфігурації онбордингу |
|
||||
| `plugin-sdk/global-singleton` | Допоміжні засоби process-local singleton/map/cache |
|
||||
| `plugin-sdk/group-activation` | Вузькі допоміжні засоби режиму активації груп і розбору команд |
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Підшляхи автентифікації та безпеки">
|
||||
| Підшлях | Ключові експорти |
|
||||
| --- | --- |
|
||||
| `plugin-sdk/command-auth` | `resolveControlCommandGate`, допоміжні функції реєстру команд, включно з форматуванням меню динамічних аргументів, допоміжні функції авторизації відправника |
|
||||
| `plugin-sdk/command-auth` | `resolveControlCommandGate`, допоміжні засоби реєстру команд, включно з форматуванням меню динамічних аргументів, допоміжні засоби авторизації відправника |
|
||||
| `plugin-sdk/command-status` | Побудовники повідомлень команд/довідки, такі як `buildCommandsMessagePaginated` і `buildHelpMessage` |
|
||||
| `plugin-sdk/approval-auth-runtime` | Допоміжні функції визначення затверджувача й автентифікації дій у тому самому чаті |
|
||||
| `plugin-sdk/approval-client-runtime` | Допоміжні функції профілю/фільтра native exec approval |
|
||||
| `plugin-sdk/approval-delivery-runtime` | Native-адаптери можливостей/доставки approval |
|
||||
| `plugin-sdk/approval-gateway-runtime` | Спільна допоміжна функція визначення approval Gateway |
|
||||
| `plugin-sdk/approval-handler-adapter-runtime` | Полегшені допоміжні функції завантаження native approval adapter для гарячих точок входу каналів |
|
||||
| `plugin-sdk/approval-handler-runtime` | Ширші допоміжні функції середовища виконання для approval handler; віддавайте перевагу вужчим adapter/gateway seam, коли їх достатньо |
|
||||
| `plugin-sdk/approval-native-runtime` | Допоміжні функції native approval target + account-binding |
|
||||
| `plugin-sdk/approval-reply-runtime` | Допоміжні функції payload відповіді для exec/plugin approval |
|
||||
| `plugin-sdk/approval-runtime` | Допоміжні функції payload для exec/plugin approval, допоміжні функції маршрутизації/середовища виконання native approval, а також допоміжні функції структурованого відображення approval, такі як `formatApprovalDisplayPath` |
|
||||
| `plugin-sdk/reply-dedupe` | Вузькі допоміжні функції скидання дедуплікації вхідних відповідей |
|
||||
| `plugin-sdk/channel-contract-testing` | Вузькі допоміжні функції тестування контракту каналу без широкого testing barrel |
|
||||
| `plugin-sdk/command-auth-native` | Native command auth, форматування меню динамічних аргументів і допоміжні функції native session-target |
|
||||
| `plugin-sdk/command-detection` | Спільні допоміжні функції виявлення команд |
|
||||
| `plugin-sdk/approval-auth-runtime` | Допоміжні засоби визначення затверджувача та авторизації дій у межах того самого чату |
|
||||
| `plugin-sdk/approval-client-runtime` | Нативні допоміжні засоби профілю/фільтра затвердження exec |
|
||||
| `plugin-sdk/approval-delivery-runtime` | Нативні адаптери можливостей/доставки затвердження |
|
||||
| `plugin-sdk/approval-gateway-runtime` | Спільний допоміжний засіб визначення Gateway затвердження |
|
||||
| `plugin-sdk/approval-handler-adapter-runtime` | Полегшені допоміжні засоби завантаження нативного адаптера затвердження для гарячих точок входу каналів |
|
||||
| `plugin-sdk/approval-handler-runtime` | Ширші допоміжні засоби runtime для обробника затвердження; надавайте перевагу вужчим adapter/gateway seams, якщо їх достатньо |
|
||||
| `plugin-sdk/approval-native-runtime` | Нативні допоміжні засоби для цілей затвердження та прив’язки облікових записів |
|
||||
| `plugin-sdk/approval-reply-runtime` | Допоміжні засоби payload відповіді на затвердження exec/plugin |
|
||||
| `plugin-sdk/approval-runtime` | Допоміжні засоби payload затвердження exec/plugin, нативні допоміжні засоби маршрутизації/runtime затвердження, а також структуровані допоміжні засоби відображення затвердження, такі як `formatApprovalDisplayPath` |
|
||||
| `plugin-sdk/reply-dedupe` | Вузькі допоміжні засоби скидання дедуплікації вхідних відповідей |
|
||||
| `plugin-sdk/channel-contract-testing` | Вузькі допоміжні засоби тестування контрактів каналу без широкого testing barrel |
|
||||
| `plugin-sdk/command-auth-native` | Нативна автентифікація команд, форматування меню динамічних аргументів і нативні допоміжні засоби session-target |
|
||||
| `plugin-sdk/command-detection` | Спільні допоміжні засоби виявлення команд |
|
||||
| `plugin-sdk/command-primitives-runtime` | Полегшені предикати тексту команд для гарячих шляхів каналів |
|
||||
| `plugin-sdk/command-surface` | Допоміжні функції нормалізації command-body і command-surface |
|
||||
| `plugin-sdk/command-surface` | Нормалізація тіла команди та допоміжні засоби command-surface |
|
||||
| `plugin-sdk/allow-from` | `formatAllowFromLowercase` |
|
||||
| `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні функції збирання secret-contract для поверхонь секретів каналу/plugin |
|
||||
| `plugin-sdk/secret-ref-runtime` | Вузькі допоміжні функції `coerceSecretRef` і типізації SecretRef для парсингу secret-contract/config |
|
||||
| `plugin-sdk/security-runtime` | Спільні допоміжні функції довіри, DM gating, зовнішнього вмісту та збирання секретів |
|
||||
| `plugin-sdk/ssrf-policy` | Допоміжні функції host allowlist і політики SSRF приватної мережі |
|
||||
| `plugin-sdk/ssrf-dispatcher` | Вузькі pinned-dispatcher helper без широкої поверхні infra runtime |
|
||||
| `plugin-sdk/ssrf-runtime` | Допоміжні функції pinned-dispatcher, SSRF-захищеного fetch і політики SSRF |
|
||||
| `plugin-sdk/secret-input` | Допоміжні функції парсингу введення секретів |
|
||||
| `plugin-sdk/webhook-ingress` | Допоміжні функції запиту/цілі Webhook |
|
||||
| `plugin-sdk/webhook-request-guards` | Допоміжні функції розміру body/timeout запиту |
|
||||
| `plugin-sdk/channel-secret-runtime` | Вузькі допоміжні засоби збирання secret-contract для поверхонь секретів каналу/plugin |
|
||||
| `plugin-sdk/secret-ref-runtime` | Вузькі допоміжні засоби `coerceSecretRef` і типізації SecretRef для розбору secret-contract/config |
|
||||
| `plugin-sdk/security-runtime` | Спільні допоміжні засоби довіри, контролю DM, зовнішнього вмісту та збирання секретів |
|
||||
| `plugin-sdk/ssrf-policy` | Допоміжні засоби політики SSRF для allowlist хостів і приватних мереж |
|
||||
| `plugin-sdk/ssrf-dispatcher` | Вузькі допоміжні засоби pinned-dispatcher без широкої поверхні runtime інфраструктури |
|
||||
| `plugin-sdk/ssrf-runtime` | Допоміжні засоби pinned-dispatcher, fetch із захистом SSRF і політики SSRF |
|
||||
| `plugin-sdk/secret-input` | Допоміжні засоби розбору введення секретів |
|
||||
| `plugin-sdk/webhook-ingress` | Допоміжні засоби запиту/цілі Webhook |
|
||||
| `plugin-sdk/webhook-request-guards` | Допоміжні засоби для розміру тіла запиту/тайм-аутів |
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Підшляхи середовища виконання та сховища">
|
||||
<Accordion title="Підшляхи runtime та сховища">
|
||||
| Підшлях | Ключові експорти |
|
||||
| --- | --- |
|
||||
| `plugin-sdk/runtime` | Широкі допоміжні функції середовища виконання/логування/резервного копіювання/встановлення plugin |
|
||||
| `plugin-sdk/runtime-env` | Вузькі допоміжні функції env середовища виконання, logger, timeout, retry і backoff |
|
||||
| `plugin-sdk/channel-runtime-context` | Загальні допоміжні функції реєстрації та пошуку channel runtime-context |
|
||||
| `plugin-sdk/runtime` | Широкі допоміжні засоби runtime/журналювання/резервного копіювання/встановлення plugin |
|
||||
| `plugin-sdk/runtime-env` | Вузькі допоміжні засоби runtime env, logger, timeout, retry та backoff |
|
||||
| `plugin-sdk/channel-runtime-context` | Загальні допоміжні засоби реєстрації та пошуку channel runtime-context |
|
||||
| `plugin-sdk/runtime-store` | `createPluginRuntimeStore` |
|
||||
| `plugin-sdk/plugin-runtime` | Спільні допоміжні функції команд/хуків/http/interactive для plugin |
|
||||
| `plugin-sdk/hook-runtime` | Спільні допоміжні функції pipeline для Webhook/internal hook |
|
||||
| `plugin-sdk/lazy-runtime` | Допоміжні функції lazy import/binding середовища виконання, такі як `createLazyRuntimeModule`, `createLazyRuntimeMethod` і `createLazyRuntimeSurface` |
|
||||
| `plugin-sdk/process-runtime` | Допоміжні функції exec процесів |
|
||||
| `plugin-sdk/cli-runtime` | Допоміжні функції форматування CLI, wait, version, argument-invocation і lazy command-group |
|
||||
| `plugin-sdk/gateway-runtime` | Допоміжні функції клієнта Gateway і patch статусу каналу |
|
||||
| `plugin-sdk/config-runtime` | Допоміжні функції завантаження/запису конфігурації та пошуку конфігурації plugin |
|
||||
| `plugin-sdk/telegram-command-config` | Допоміжні функції нормалізації імен/описів команд Telegram і перевірки дублікатів/конфліктів, навіть коли поверхня bundled Telegram contract недоступна |
|
||||
| `plugin-sdk/text-autolink-runtime` | Виявлення autolink посилань на файли без широкого text-runtime barrel |
|
||||
| `plugin-sdk/approval-runtime` | Допоміжні функції approval для exec/plugin, побудовники approval-capability, допоміжні функції auth/profile, допоміжні функції native routing/runtime і форматування шляху структурованого відображення approval |
|
||||
| `plugin-sdk/reply-runtime` | Спільні допоміжні функції середовища виконання для inbound/reply, chunking, dispatch, Heartbeat, планувальник відповідей |
|
||||
| `plugin-sdk/reply-dispatch-runtime` | Вузькі допоміжні функції dispatch/finalize відповідей і міток conversation |
|
||||
| `plugin-sdk/reply-history` | Спільні допоміжні функції коротковіконної історії відповідей, такі як `buildHistoryContext`, `recordPendingHistoryEntry` і `clearHistoryEntriesIfEnabled` |
|
||||
| `plugin-sdk/plugin-runtime` | Спільні допоміжні засоби команд/hook/http/interactive для plugin |
|
||||
| `plugin-sdk/hook-runtime` | Спільні допоміжні засоби конвеєра Webhook/внутрішніх hook |
|
||||
| `plugin-sdk/lazy-runtime` | Допоміжні засоби лінивого імпорту/прив’язки runtime, такі як `createLazyRuntimeModule`, `createLazyRuntimeMethod` і `createLazyRuntimeSurface` |
|
||||
| `plugin-sdk/process-runtime` | Допоміжні засоби exec процесів |
|
||||
| `plugin-sdk/cli-runtime` | Допоміжні засоби форматування CLI, очікування, версій, виклику аргументів і лінивих груп команд |
|
||||
| `plugin-sdk/gateway-runtime` | Допоміжні засоби клієнта Gateway і patch статусу каналу |
|
||||
| `plugin-sdk/config-runtime` | Допоміжні засоби завантаження/запису конфігурації та пошуку конфігурації plugin |
|
||||
| `plugin-sdk/telegram-command-config` | Допоміжні засоби нормалізації назв/описів команд Telegram і перевірки дублікатів/конфліктів, навіть коли поверхня bundled Telegram contract недоступна |
|
||||
| `plugin-sdk/text-autolink-runtime` | Виявлення autolink для посилань на файли без широкого barrel `text-runtime` |
|
||||
| `plugin-sdk/approval-runtime` | Допоміжні засоби затвердження exec/plugin, побудовники можливостей затвердження, допоміжні засоби auth/profile, нативні допоміжні засоби маршрутизації/runtime та форматування шляхів структурованого відображення затвердження |
|
||||
| `plugin-sdk/reply-runtime` | Спільні допоміжні засоби runtime для вхідних повідомлень/відповідей, chunking, dispatch, Heartbeat, планувальник відповідей |
|
||||
| `plugin-sdk/reply-dispatch-runtime` | Вузькі допоміжні засоби dispatch/finalize відповідей і міток conversation |
|
||||
| `plugin-sdk/reply-history` | Спільні допоміжні засоби коротковіконної історії відповідей, такі як `buildHistoryContext`, `recordPendingHistoryEntry` і `clearHistoryEntriesIfEnabled` |
|
||||
| `plugin-sdk/reply-reference` | `createReplyReferencePlanner` |
|
||||
| `plugin-sdk/reply-chunking` | Вузькі допоміжні функції chunking тексту/Markdown |
|
||||
| `plugin-sdk/session-store-runtime` | Допоміжні функції шляху session store + updated-at |
|
||||
| `plugin-sdk/state-paths` | Допоміжні функції шляхів каталогів state/OAuth |
|
||||
| `plugin-sdk/routing` | Допоміжні функції route/session-key/account binding, такі як `resolveAgentRoute`, `buildAgentSessionKey` і `resolveDefaultAgentBoundAccountId` |
|
||||
| `plugin-sdk/status-helpers` | Спільні допоміжні функції підсумку статусу каналу/облікового запису, значення runtime-state за замовчуванням і допоміжні функції метаданих issue |
|
||||
| `plugin-sdk/target-resolver-runtime` | Спільні допоміжні функції визначення цілі |
|
||||
| `plugin-sdk/string-normalization-runtime` | Допоміжні функції нормалізації slug/рядків |
|
||||
| `plugin-sdk/request-url` | Витягування рядкових URL із fetch/request-подібних вхідних даних |
|
||||
| `plugin-sdk/run-command` | Виконавець команд із таймером і нормалізованими результатами stdout/stderr |
|
||||
| `plugin-sdk/param-readers` | Поширені зчитувачі параметрів tool/CLI |
|
||||
| `plugin-sdk/tool-payload` | Витягування нормалізованих payload з об’єктів результатів tool |
|
||||
| `plugin-sdk/reply-chunking` | Вузькі допоміжні засоби chunking тексту/Markdown |
|
||||
| `plugin-sdk/session-store-runtime` | Допоміжні засоби для шляху сховища сесій і `updated-at` |
|
||||
| `plugin-sdk/state-paths` | Допоміжні засоби шляхів каталогів стану/OAuth |
|
||||
| `plugin-sdk/routing` | Допоміжні засоби маршруту/ключа сесії/прив’язки облікового запису, такі як `resolveAgentRoute`, `buildAgentSessionKey` і `resolveDefaultAgentBoundAccountId` |
|
||||
| `plugin-sdk/status-helpers` | Спільні допоміжні засоби зведення статусу каналу/облікового запису, значення стану runtime за замовчуванням і допоміжні засоби метаданих проблем |
|
||||
| `plugin-sdk/target-resolver-runtime` | Спільні допоміжні засоби визначення цілі |
|
||||
| `plugin-sdk/string-normalization-runtime` | Допоміжні засоби нормалізації slug/рядків |
|
||||
| `plugin-sdk/request-url` | Витягування рядкових URL із входів типу fetch/request |
|
||||
| `plugin-sdk/run-command` | Виконавець команд із тайм-лімітом і нормалізованими результатами stdout/stderr |
|
||||
| `plugin-sdk/param-readers` | Поширені читачі параметрів tool/CLI |
|
||||
| `plugin-sdk/tool-payload` | Витягування нормалізованих payload із об’єктів результатів tool |
|
||||
| `plugin-sdk/tool-send` | Витягування канонічних полів цілі надсилання з аргументів tool |
|
||||
| `plugin-sdk/temp-path` | Спільні допоміжні функції шляхів тимчасового завантаження |
|
||||
| `plugin-sdk/logging-core` | Допоміжні функції subsystem logger і редагування чутливих даних |
|
||||
| `plugin-sdk/markdown-table-runtime` | Допоміжні функції режиму та перетворення таблиць Markdown |
|
||||
| `plugin-sdk/json-store` | Допоміжні функції читання/запису малого JSON state |
|
||||
| `plugin-sdk/file-lock` | Повторно вхідні допоміжні функції file-lock |
|
||||
| `plugin-sdk/persistent-dedupe` | Допоміжні функції кешу дедуплікації з дисковою підтримкою |
|
||||
| `plugin-sdk/acp-runtime` | Допоміжні функції ACP runtime/session і reply-dispatch |
|
||||
| `plugin-sdk/acp-binding-resolve-runtime` | Розв’язання binding ACP лише для читання без імпортів запуску життєвого циклу |
|
||||
| `plugin-sdk/agent-config-primitives` | Вузькі примітиви config-schema середовища виконання агента |
|
||||
| `plugin-sdk/boolean-param` | Нестрогий зчитувач булевих параметрів |
|
||||
| `plugin-sdk/dangerous-name-runtime` | Допоміжні функції визначення збігів небезпечних назв |
|
||||
| `plugin-sdk/device-bootstrap` | Допоміжні функції bootstrap пристрою та pairing token |
|
||||
| `plugin-sdk/extension-shared` | Спільні примітиви допоміжних функцій passive-channel, status і ambient proxy |
|
||||
| `plugin-sdk/models-provider-runtime` | Допоміжні функції команди `/models`/відповіді провайдера |
|
||||
| `plugin-sdk/skill-commands-runtime` | Допоміжні функції переліку команд Skills |
|
||||
| `plugin-sdk/native-command-registry` | Допоміжні функції реєстру/build/serialize native command |
|
||||
| `plugin-sdk/agent-harness` | Експериментальна поверхня trusted-plugin для низькорівневих agent harness: типи harness, допоміжні функції steer/abort активного запуску, місток tool OpenClaw, допоміжні функції форматування/деталізації прогресу tool і утиліти результатів спроб |
|
||||
| `plugin-sdk/provider-zai-endpoint` | Допоміжні функції виявлення endpoint Z.A.I |
|
||||
| `plugin-sdk/infra-runtime` | Допоміжні функції системних подій/Heartbeat |
|
||||
| `plugin-sdk/collection-runtime` | Допоміжні функції малого обмеженого кешу |
|
||||
| `plugin-sdk/diagnostic-runtime` | Допоміжні функції діагностичних прапорців і подій |
|
||||
| `plugin-sdk/error-runtime` | Допоміжні функції графа помилок, форматування, спільної класифікації помилок, `isApprovalNotFoundError` |
|
||||
| `plugin-sdk/fetch-runtime` | Допоміжні функції обгорнутого fetch, proxy і pinned lookup |
|
||||
| `plugin-sdk/temp-path` | Спільні допоміжні засоби для шляхів тимчасового завантаження |
|
||||
| `plugin-sdk/logging-core` | Допоміжні засоби subsystem logger і редагування конфіденційних даних |
|
||||
| `plugin-sdk/markdown-table-runtime` | Допоміжні засоби режиму й перетворення таблиць Markdown |
|
||||
| `plugin-sdk/json-store` | Невеликі допоміжні засоби читання/запису стану JSON |
|
||||
| `plugin-sdk/file-lock` | Реентерабельні допоміжні засоби file-lock |
|
||||
| `plugin-sdk/persistent-dedupe` | Допоміжні засоби кешу дедуплікації з дисковою підтримкою |
|
||||
| `plugin-sdk/acp-runtime` | Допоміжні засоби runtime/сесії ACP і dispatch відповідей |
|
||||
| `plugin-sdk/acp-binding-resolve-runtime` | Визначення прив’язки ACP лише для читання без імпортів запуску життєвого циклу |
|
||||
| `plugin-sdk/agent-config-primitives` | Вузькі примітиви config-schema runtime агента |
|
||||
| `plugin-sdk/boolean-param` | Нестрогий читач булевих параметрів |
|
||||
| `plugin-sdk/dangerous-name-runtime` | Допоміжні засоби визначення збігів небезпечних назв |
|
||||
| `plugin-sdk/device-bootstrap` | Допоміжні засоби bootstrap пристрою та токенів pairing |
|
||||
| `plugin-sdk/extension-shared` | Спільні примітиви допоміжних засобів passive-channel, status і ambient proxy |
|
||||
| `plugin-sdk/models-provider-runtime` | Допоміжні засоби відповідей провайдера/команди `/models` |
|
||||
| `plugin-sdk/skill-commands-runtime` | Допоміжні засоби виведення списку команд Skills |
|
||||
| `plugin-sdk/native-command-registry` | Допоміжні засоби реєстру/побудови/серіалізації нативних команд |
|
||||
| `plugin-sdk/agent-harness` | Експериментальна поверхня trusted-plugin для низькорівневих harness агента: типи harness, допоміжні засоби керування/переривання активного запуску, допоміжні засоби мосту tool OpenClaw, допоміжні засоби політики tool для плану runtime, класифікація результатів terminal, допоміжні засоби форматування/деталізації прогресу tool і утиліти результатів спроб |
|
||||
| `plugin-sdk/provider-zai-endpoint` | Допоміжні засоби виявлення endpoint Z.A.I |
|
||||
| `plugin-sdk/infra-runtime` | Допоміжні засоби системних подій/Heartbeat |
|
||||
| `plugin-sdk/collection-runtime` | Невеликі допоміжні засоби обмеженого кешу |
|
||||
| `plugin-sdk/diagnostic-runtime` | Допоміжні засоби діагностичних прапорців і подій |
|
||||
| `plugin-sdk/error-runtime` | Допоміжні засоби графа помилок, форматування, спільної класифікації помилок, `isApprovalNotFoundError` |
|
||||
| `plugin-sdk/fetch-runtime` | Допоміжні засоби обгорнутого fetch, proxy та pinned lookup |
|
||||
| `plugin-sdk/runtime-fetch` | Runtime fetch з урахуванням dispatcher без імпортів proxy/guarded-fetch |
|
||||
| `plugin-sdk/response-limit-runtime` | Обмежений зчитувач response-body без широкої поверхні media runtime |
|
||||
| `plugin-sdk/session-binding-runtime` | Поточний стан binding розмови без маршрутизації configured binding або pairing stores |
|
||||
| `plugin-sdk/session-store-runtime` | Допоміжні функції читання session-store без широких імпортів запису/обслуговування конфігурації |
|
||||
| `plugin-sdk/context-visibility-runtime` | Допоміжні функції визначення видимості контексту та фільтрації додаткового контексту без широких імпортів config/security |
|
||||
| `plugin-sdk/string-coerce-runtime` | Вузькі допоміжні функції приведення та нормалізації primitive record/string без імпортів markdown/logging |
|
||||
| `plugin-sdk/host-runtime` | Допоміжні функції нормалізації hostname і SCP host |
|
||||
| `plugin-sdk/retry-runtime` | Допоміжні функції конфігурації retry і виконавця retry |
|
||||
| `plugin-sdk/agent-runtime` | Допоміжні функції каталогів/ідентичності/робочого простору агента |
|
||||
| `plugin-sdk/response-limit-runtime` | Читач тіла відповіді з обмеженням без широкої поверхні media runtime |
|
||||
| `plugin-sdk/session-binding-runtime` | Поточний стан прив’язки conversation без маршрутизації налаштованих прив’язок або сховищ pairing |
|
||||
| `plugin-sdk/session-store-runtime` | Допоміжні засоби читання сховища сесій без широких імпортів запису/обслуговування конфігурації |
|
||||
| `plugin-sdk/context-visibility-runtime` | Допоміжні засоби визначення видимості контексту та фільтрації додаткового контексту без широких імпортів config/security |
|
||||
| `plugin-sdk/string-coerce-runtime` | Вузькі допоміжні засоби приведення та нормалізації примітивних record/string без імпортів markdown/logging |
|
||||
| `plugin-sdk/host-runtime` | Допоміжні засоби нормалізації hostname і SCP host |
|
||||
| `plugin-sdk/retry-runtime` | Допоміжні засоби конфігурації retry і виконавця retry |
|
||||
| `plugin-sdk/agent-runtime` | Допоміжні засоби каталогу/ідентичності/робочого простору агента |
|
||||
| `plugin-sdk/directory-runtime` | Запит/dedup каталогів на основі конфігурації |
|
||||
| `plugin-sdk/keyed-async-queue` | `KeyedAsyncQueue` |
|
||||
</Accordion>
|
||||
@ -221,25 +221,25 @@ x-i18n:
|
||||
<Accordion title="Підшляхи можливостей і тестування">
|
||||
| Підшлях | Ключові експорти |
|
||||
| --- | --- |
|
||||
| `plugin-sdk/media-runtime` | Спільні допоміжні функції fetch/transform/store медіа, а також побудовники media payload |
|
||||
| `plugin-sdk/media-store` | Вузькі допоміжні функції media store, такі як `saveMediaBuffer` |
|
||||
| `plugin-sdk/media-generation-runtime` | Спільні допоміжні функції failover генерації медіа, вибору кандидатів і повідомлень про відсутню модель |
|
||||
| `plugin-sdk/media-understanding` | Типи провайдера розуміння медіа, а також орієнтовані на провайдер експорти допоміжних функцій для зображень/аудіо |
|
||||
| `plugin-sdk/text-runtime` | Спільні допоміжні функції text/Markdown/logging, такі як видалення видимого для асистента тексту, допоміжні функції рендерингу/chunking/таблиць Markdown, допоміжні функції редагування чутливих даних, directive-tag і утиліти безпечного тексту |
|
||||
| `plugin-sdk/text-chunking` | Допоміжна функція chunking вихідного тексту |
|
||||
| `plugin-sdk/speech` | Типи speech provider, а також орієнтовані на провайдер експорти directive, registry, validation і speech helper |
|
||||
| `plugin-sdk/speech-core` | Спільні типи speech provider, експорти registry, directive, normalization і speech helper |
|
||||
| `plugin-sdk/realtime-transcription` | Типи провайдера realtime transcription, допоміжні функції registry і спільна допоміжна функція сесії WebSocket |
|
||||
| `plugin-sdk/realtime-voice` | Типи провайдера realtime voice і допоміжні функції registry |
|
||||
| `plugin-sdk/image-generation` | Типи провайдера генерації зображень |
|
||||
| `plugin-sdk/image-generation-core` | Спільні типи генерації зображень, допоміжні функції failover, auth і registry |
|
||||
| `plugin-sdk/music-generation` | Типи провайдера/запиту/результату генерації музики |
|
||||
| `plugin-sdk/music-generation-core` | Спільні типи генерації музики, допоміжні функції failover, пошуку провайдера та парсингу model-ref |
|
||||
| `plugin-sdk/video-generation` | Типи провайдера/запиту/результату генерації відео |
|
||||
| `plugin-sdk/video-generation-core` | Спільні типи генерації відео, допоміжні функції failover, пошуку провайдера та парсингу model-ref |
|
||||
| `plugin-sdk/webhook-targets` | Реєстр цілей Webhook і допоміжні функції встановлення route |
|
||||
| `plugin-sdk/webhook-path` | Допоміжні функції нормалізації шляху Webhook |
|
||||
| `plugin-sdk/web-media` | Спільні допоміжні функції завантаження віддалених/локальних медіа |
|
||||
| `plugin-sdk/media-runtime` | Спільні допоміжні засоби отримання/перетворення/збереження медіа, а також побудовники payload медіа |
|
||||
| `plugin-sdk/media-store` | Вузькі допоміжні засоби сховища медіа, такі як `saveMediaBuffer` |
|
||||
| `plugin-sdk/media-generation-runtime` | Спільні допоміжні засоби failover генерації медіа, вибору кандидатів і повідомлень про відсутні моделі |
|
||||
| `plugin-sdk/media-understanding` | Типи провайдерів media understanding, а також орієнтовані на провайдера допоміжні експорти для зображень/аудіо |
|
||||
| `plugin-sdk/text-runtime` | Спільні допоміжні засоби тексту/Markdown/журналювання, такі як видалення видимого для асистента тексту, допоміжні засоби рендерингу/chunking/таблиць Markdown, редагування конфіденційних даних, допоміжні засоби тегів директив і утиліти безпечного тексту |
|
||||
| `plugin-sdk/text-chunking` | Допоміжний засіб chunking вихідного тексту |
|
||||
| `plugin-sdk/speech` | Типи провайдерів мовлення, а також орієнтовані на провайдера експорти директив, реєстру, валідації та допоміжних засобів мовлення |
|
||||
| `plugin-sdk/speech-core` | Спільні типи провайдерів мовлення, реєстр, директива, нормалізація та експорти допоміжних засобів мовлення |
|
||||
| `plugin-sdk/realtime-transcription` | Типи провайдерів транскрипції в реальному часі, допоміжні засоби реєстру та спільний допоміжний засіб сесії WebSocket |
|
||||
| `plugin-sdk/realtime-voice` | Типи провайдерів голосу в реальному часі та допоміжні засоби реєстру |
|
||||
| `plugin-sdk/image-generation` | Типи провайдерів генерації зображень |
|
||||
| `plugin-sdk/image-generation-core` | Спільні типи генерації зображень, допоміжні засоби failover, auth і реєстру |
|
||||
| `plugin-sdk/music-generation` | Типи провайдерів/запитів/результатів генерації музики |
|
||||
| `plugin-sdk/music-generation-core` | Спільні типи генерації музики, допоміжні засоби failover, пошук провайдера та розбір model-ref |
|
||||
| `plugin-sdk/video-generation` | Типи провайдерів/запитів/результатів генерації відео |
|
||||
| `plugin-sdk/video-generation-core` | Спільні типи генерації відео, допоміжні засоби failover, пошук провайдера та розбір model-ref |
|
||||
| `plugin-sdk/webhook-targets` | Допоміжні засоби реєстру цілей Webhook та встановлення маршрутів |
|
||||
| `plugin-sdk/webhook-path` | Допоміжні засоби нормалізації шляху Webhook |
|
||||
| `plugin-sdk/web-media` | Спільні допоміжні засоби завантаження віддалених/локальних медіа |
|
||||
| `plugin-sdk/zod` | Повторно експортований `zod` для споживачів Plugin SDK |
|
||||
| `plugin-sdk/testing` | `installCommonResolveTargetErrorCases`, `shouldAckReaction` |
|
||||
</Accordion>
|
||||
@ -247,43 +247,43 @@ x-i18n:
|
||||
<Accordion title="Підшляхи пам’яті">
|
||||
| Підшлях | Ключові експорти |
|
||||
| --- | --- |
|
||||
| `plugin-sdk/memory-core` | Поверхня допоміжних функцій bundled memory-core для manager/config/file/CLI helper |
|
||||
| `plugin-sdk/memory-core-engine-runtime` | Фасад середовища виконання індексації/пошуку Memory |
|
||||
| `plugin-sdk/memory-core-host-engine-foundation` | Експорти foundation engine хоста Memory |
|
||||
| `plugin-sdk/memory-core-host-engine-embeddings` | Контракти embedding хоста Memory, доступ до registry, локальний провайдер і загальні batch/remote helper |
|
||||
| `plugin-sdk/memory-core-host-engine-qmd` | Експорти QMD engine хоста Memory |
|
||||
| `plugin-sdk/memory-core-host-engine-storage` | Експорти storage engine хоста Memory |
|
||||
| `plugin-sdk/memory-core-host-multimodal` | Мультимодальні helper хоста Memory |
|
||||
| `plugin-sdk/memory-core-host-query` | Helper запитів хоста Memory |
|
||||
| `plugin-sdk/memory-core-host-secret` | Helper секретів хоста Memory |
|
||||
| `plugin-sdk/memory-core-host-events` | Helper журналу подій хоста Memory |
|
||||
| `plugin-sdk/memory-core-host-status` | Helper статусу хоста Memory |
|
||||
| `plugin-sdk/memory-core-host-runtime-cli` | Helper середовища виконання CLI хоста Memory |
|
||||
| `plugin-sdk/memory-core-host-runtime-core` | Базові helper середовища виконання хоста Memory |
|
||||
| `plugin-sdk/memory-core-host-runtime-files` | Helper файлів/середовища виконання хоста Memory |
|
||||
| `plugin-sdk/memory-host-core` | Нейтральний до постачальника псевдонім для базових helper середовища виконання хоста Memory |
|
||||
| `plugin-sdk/memory-host-events` | Нейтральний до постачальника псевдонім для helper журналу подій хоста Memory |
|
||||
| `plugin-sdk/memory-host-files` | Нейтральний до постачальника псевдонім для helper файлів/середовища виконання хоста Memory |
|
||||
| `plugin-sdk/memory-host-markdown` | Спільні helper керованого Markdown для plugin, пов’язаних із пам’яттю |
|
||||
| `plugin-sdk/memory-host-search` | Фасад середовища виконання Active Memory для доступу до search-manager |
|
||||
| `plugin-sdk/memory-host-status` | Нейтральний до постачальника псевдонім для helper статусу хоста Memory |
|
||||
| `plugin-sdk/memory-lancedb` | Поверхня допоміжних функцій bundled memory-lancedb |
|
||||
| `plugin-sdk/memory-core` | Поверхня допоміжних засобів bundled memory-core для менеджера/конфігурації/файлів/допоміжних засобів CLI |
|
||||
| `plugin-sdk/memory-core-engine-runtime` | Фасад runtime індексації/пошуку пам’яті |
|
||||
| `plugin-sdk/memory-core-host-engine-foundation` | Експорти foundation engine хоста пам’яті |
|
||||
| `plugin-sdk/memory-core-host-engine-embeddings` | Контракти embedding хоста пам’яті, доступ до реєстру, локальний провайдер і загальні допоміжні засоби пакетної/віддаленої обробки |
|
||||
| `plugin-sdk/memory-core-host-engine-qmd` | Експорти QMD engine хоста пам’яті |
|
||||
| `plugin-sdk/memory-core-host-engine-storage` | Експорти storage engine хоста пам’яті |
|
||||
| `plugin-sdk/memory-core-host-multimodal` | Багатомодальні допоміжні засоби хоста пам’яті |
|
||||
| `plugin-sdk/memory-core-host-query` | Допоміжні засоби запитів хоста пам’яті |
|
||||
| `plugin-sdk/memory-core-host-secret` | Допоміжні засоби секретів хоста пам’яті |
|
||||
| `plugin-sdk/memory-core-host-events` | Допоміжні засоби журналу подій хоста пам’яті |
|
||||
| `plugin-sdk/memory-core-host-status` | Допоміжні засоби статусу хоста пам’яті |
|
||||
| `plugin-sdk/memory-core-host-runtime-cli` | Допоміжні засоби runtime CLI хоста пам’яті |
|
||||
| `plugin-sdk/memory-core-host-runtime-core` | Основні допоміжні засоби runtime хоста пам’яті |
|
||||
| `plugin-sdk/memory-core-host-runtime-files` | Допоміжні засоби файлів/runtime хоста пам’яті |
|
||||
| `plugin-sdk/memory-host-core` | Нейтральний щодо постачальника псевдонім для основних допоміжних засобів runtime хоста пам’яті |
|
||||
| `plugin-sdk/memory-host-events` | Нейтральний щодо постачальника псевдонім для допоміжних засобів журналу подій хоста пам’яті |
|
||||
| `plugin-sdk/memory-host-files` | Нейтральний щодо постачальника псевдонім для допоміжних засобів файлів/runtime хоста пам’яті |
|
||||
| `plugin-sdk/memory-host-markdown` | Спільні допоміжні засоби managed-markdown для plugins, суміжних із пам’яттю |
|
||||
| `plugin-sdk/memory-host-search` | Фасад runtime Active Memory для доступу до search-manager |
|
||||
| `plugin-sdk/memory-host-status` | Нейтральний щодо постачальника псевдонім для допоміжних засобів статусу хоста пам’яті |
|
||||
| `plugin-sdk/memory-lancedb` | Поверхня допоміжних засобів bundled memory-lancedb |
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Зарезервовані підшляхи bundled-helper">
|
||||
| Сімейство | Поточні підшляхи | Призначення |
|
||||
| --- | --- | --- |
|
||||
| Browser | `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` | Допоміжні helper підтримки bundled browser plugin. `browser-profiles` експортує `resolveBrowserConfig`, `resolveProfile`, `ResolvedBrowserConfig`, `ResolvedBrowserProfile` і `ResolvedBrowserTabCleanupConfig` для нормалізованої форми `browser.tabCleanup`. `browser-support` лишається barrel сумісності. |
|
||||
| Matrix | `plugin-sdk/matrix`, `plugin-sdk/matrix-helper`, `plugin-sdk/matrix-runtime-heavy`, `plugin-sdk/matrix-runtime-shared`, `plugin-sdk/matrix-runtime-surface`, `plugin-sdk/matrix-surface`, `plugin-sdk/matrix-thread-bindings` | Поверхня helper/середовища виконання bundled Matrix |
|
||||
| Line | `plugin-sdk/line`, `plugin-sdk/line-core`, `plugin-sdk/line-runtime`, `plugin-sdk/line-surface` | Поверхня helper/середовища виконання bundled LINE |
|
||||
| IRC | `plugin-sdk/irc`, `plugin-sdk/irc-surface` | Поверхня допоміжних функцій bundled IRC |
|
||||
| Допоміжні функції для конкретних каналів | `plugin-sdk/googlechat`, `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles`, `plugin-sdk/bluebubbles-policy`, `plugin-sdk/mattermost`, `plugin-sdk/mattermost-policy`, `plugin-sdk/feishu-conversation`, `plugin-sdk/msteams`, `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`, `plugin-sdk/twitch` | Bundled шви сумісності/допоміжних функцій каналів |
|
||||
| Допоміжні функції для автентифікації/конкретних plugin | `plugin-sdk/github-copilot-login`, `plugin-sdk/github-copilot-token`, `plugin-sdk/diagnostics-otel`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`, `plugin-sdk/thread-ownership`, `plugin-sdk/voice-call` | Bundled шви допоміжних функцій функцій/plugin; `plugin-sdk/github-copilot-token` наразі експортує `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` і `resolveCopilotApiToken` |
|
||||
| Browser | `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` | Допоміжні засоби підтримки bundled browser plugin. `browser-profiles` експортує `resolveBrowserConfig`, `resolveProfile`, `ResolvedBrowserConfig`, `ResolvedBrowserProfile` і `ResolvedBrowserTabCleanupConfig` для нормалізованої форми `browser.tabCleanup`. `browser-support` залишається сумісним barrel. |
|
||||
| Matrix | `plugin-sdk/matrix`, `plugin-sdk/matrix-helper`, `plugin-sdk/matrix-runtime-heavy`, `plugin-sdk/matrix-runtime-shared`, `plugin-sdk/matrix-runtime-surface`, `plugin-sdk/matrix-surface`, `plugin-sdk/matrix-thread-bindings` | Поверхня допоміжних засобів/runtime bundled Matrix |
|
||||
| Line | `plugin-sdk/line`, `plugin-sdk/line-core`, `plugin-sdk/line-runtime`, `plugin-sdk/line-surface` | Поверхня допоміжних засобів/runtime bundled LINE |
|
||||
| IRC | `plugin-sdk/irc`, `plugin-sdk/irc-surface` | Поверхня допоміжних засобів bundled IRC |
|
||||
| Допоміжні засоби, специфічні для каналів | `plugin-sdk/googlechat`, `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles`, `plugin-sdk/bluebubbles-policy`, `plugin-sdk/mattermost`, `plugin-sdk/mattermost-policy`, `plugin-sdk/feishu-conversation`, `plugin-sdk/msteams`, `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`, `plugin-sdk/twitch` | Bundled seams сумісності/допоміжних засобів для каналів |
|
||||
| Допоміжні засоби, специфічні для auth/plugin | `plugin-sdk/github-copilot-login`, `plugin-sdk/github-copilot-token`, `plugin-sdk/diagnostics-otel`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`, `plugin-sdk/thread-ownership`, `plugin-sdk/voice-call` | Bundled seams допоміжних засобів для функцій/plugins; `plugin-sdk/github-copilot-token` наразі експортує `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` і `resolveCopilotApiToken` |
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
## Пов’язане
|
||||
## Пов’язані матеріали
|
||||
|
||||
- [Огляд Plugin SDK](/uk/plugins/sdk-overview)
|
||||
- [Налаштування Plugin SDK](/uk/plugins/sdk-setup)
|
||||
- [Створення plugin](/uk/plugins/building-plugins)
|
||||
- [Створення plugins](/uk/plugins/building-plugins)
|
||||
|
||||
Loading…
Reference in New Issue
Block a user