@iola_adm/iola-cli 0.1.29 → 0.1.31
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +15 -2
- package/package.json +1 -1
- package/src/cli.js +1013 -25
- package/wiki/Home.md +2 -0
- package/wiki//320/221/321/200/320/260/321/203/320/267/320/265/321/200/320/275/321/213/320/271-/320/260/320/263/320/265/320/275/321/202.md +68 -0
- package/wiki//320/232/320/276/320/274/320/260/320/275/320/264/321/213.md +17 -0
- package/wiki//320/237/320/273/320/260/321/202/321/204/320/276/321/200/320/274/320/260-/320/260/320/263/320/265/320/275/321/202/320/260.md +104 -0
package/wiki/Home.md
CHANGED
|
@@ -31,6 +31,8 @@ iola ask "найди школу 29"
|
|
|
31
31
|
- [Skills и toolsets](Skills-и-toolsets)
|
|
32
32
|
- [Локальные файлы](Локальные-файлы)
|
|
33
33
|
- [Рабочая среда агента](Рабочая-среда-агента)
|
|
34
|
+
- [Платформа агента](Платформа-агента)
|
|
35
|
+
- [Браузерный агент](Браузерный-агент)
|
|
34
36
|
- [Расширения и локальные данные](Расширения-и-локальные-данные)
|
|
35
37
|
- [Архивы и мастер настройки](Архивы-и-мастер-настройки)
|
|
36
38
|
- [Daemon, RPC и cron](Daemon-RPC-и-cron)
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
# Браузерный агент
|
|
2
|
+
|
|
3
|
+
`iola-cli` умеет подключать локальный браузерный runtime на Playwright. Сам npm-пакет остается легким: Chromium и Playwright ставятся отдельно при первом включении браузера.
|
|
4
|
+
|
|
5
|
+
## Установка
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
iola browser status
|
|
9
|
+
iola browser install
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
Runtime хранится в `~/.iola/browser-runtime`.
|
|
13
|
+
|
|
14
|
+
## Базовые команды
|
|
15
|
+
|
|
16
|
+
```bash
|
|
17
|
+
iola browser open https://example.com
|
|
18
|
+
iola browser text https://example.com
|
|
19
|
+
iola browser html https://example.com --output page.html
|
|
20
|
+
iola browser screenshot https://example.com --output page.png
|
|
21
|
+
iola browser pdf https://example.com --output page.pdf
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
`open` запускает видимый Chromium и держит его открытым. По умолчанию окно живет 10 минут. Можно задать время:
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
iola browser open https://example.com --wait 30000
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## Действия на странице
|
|
31
|
+
|
|
32
|
+
Клик:
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
iola browser click https://example.com --selector "button" --output after-click.png
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
Ввод:
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
iola browser type https://example.com --selector "#q" --text "школа 29" --press Enter --wait 2000 --output search.png
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
Выполнение JavaScript-выражения:
|
|
45
|
+
|
|
46
|
+
```bash
|
|
47
|
+
iola browser eval https://example.com --script "document.title"
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
## MCP
|
|
51
|
+
|
|
52
|
+
Локальный MCP server также отдает браузерные tools:
|
|
53
|
+
|
|
54
|
+
- `browser.text`;
|
|
55
|
+
- `browser.screenshot`.
|
|
56
|
+
|
|
57
|
+
Перед использованием этих tools нужно один раз выполнить:
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
iola browser install
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
## Режимы
|
|
64
|
+
|
|
65
|
+
- Для чтения страниц используйте `text`, `html`, `screenshot`, `pdf`.
|
|
66
|
+
- Для действий используйте `click` и `type`.
|
|
67
|
+
- Для ручной авторизации или просмотра используйте `open`.
|
|
68
|
+
|
|
@@ -35,6 +35,7 @@ iola quality
|
|
|
35
35
|
iola history search "Петрова"
|
|
36
36
|
iola sessions search "Петрова"
|
|
37
37
|
iola sessions compact 1
|
|
38
|
+
iola sessions replay 1
|
|
38
39
|
```
|
|
39
40
|
|
|
40
41
|
AI:
|
|
@@ -45,7 +46,10 @@ iola ask "найди школу 29" --schema json
|
|
|
45
46
|
iola ask "найди школу 29" --bare --quiet
|
|
46
47
|
iola agents list
|
|
47
48
|
iola agents run quality-checker "проверь школы"
|
|
49
|
+
iola subagents list
|
|
50
|
+
iola subagents run data-analyst "найди школы"
|
|
48
51
|
iola skills list
|
|
52
|
+
iola skills bundles
|
|
49
53
|
iola tools toolsets
|
|
50
54
|
iola files status
|
|
51
55
|
iola files mode read-only
|
|
@@ -55,7 +59,11 @@ iola policy use analyst
|
|
|
55
59
|
iola tasks list
|
|
56
60
|
iola artifacts list
|
|
57
61
|
iola snapshot list
|
|
62
|
+
iola sandbox fork
|
|
58
63
|
iola trace last
|
|
64
|
+
iola trajectory last
|
|
65
|
+
iola usage summary
|
|
66
|
+
iola budget status
|
|
59
67
|
iola export education-contacts --format xlsx --output contacts.xlsx
|
|
60
68
|
iola changes list
|
|
61
69
|
iola archive doctor
|
|
@@ -66,8 +74,15 @@ iola import file data.csv --dataset custom
|
|
|
66
74
|
iola index folder ./docs
|
|
67
75
|
iola reports list
|
|
68
76
|
iola plugins list
|
|
77
|
+
iola browser status
|
|
78
|
+
iola browser install
|
|
79
|
+
iola browser text https://example.com
|
|
80
|
+
iola browser screenshot https://example.com --output page.png
|
|
69
81
|
iola mcp serve
|
|
82
|
+
iola mcp serve --stdio
|
|
70
83
|
iola memory suggest
|
|
84
|
+
iola memory curate
|
|
85
|
+
iola review config
|
|
71
86
|
```
|
|
72
87
|
|
|
73
88
|
Контекст, расписания и daemon:
|
|
@@ -75,6 +90,8 @@ iola memory suggest
|
|
|
75
90
|
```bash
|
|
76
91
|
iola context init
|
|
77
92
|
iola context list
|
|
93
|
+
iola settings list
|
|
94
|
+
iola settings validate
|
|
78
95
|
iola cron add "каждый день 09:00 -- quality"
|
|
79
96
|
iola cron tick
|
|
80
97
|
iola daemon status
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
# Платформа агента
|
|
2
|
+
|
|
3
|
+
`iola-cli` можно использовать не только как набор команд, но и как локальную платформу агента для работы с открытыми данными городского округа "Город Йошкар-Ола".
|
|
4
|
+
|
|
5
|
+
## MCP server
|
|
6
|
+
|
|
7
|
+
Локальный MCP server поддерживает `stdio` и HTTP:
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
iola mcp serve --stdio
|
|
11
|
+
iola mcp serve
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
Доступные MCP-разделы:
|
|
15
|
+
|
|
16
|
+
- `tools/list`, `tools/call`: `status`, `search`, `card`, `quality`, `sync`, `files.tree`, `files.read`, `files.search`, `index.search`, `report`;
|
|
17
|
+
- `resources/list`, `resources/read`: `iola://status`, `iola://sync`, `iola://settings`, `iola://skills`, `iola://memory`, `iola://artifacts`;
|
|
18
|
+
- `prompts/list`, `prompts/get`: `data-question`, `document-review`, `report-build`.
|
|
19
|
+
|
|
20
|
+
## Настройки слоями
|
|
21
|
+
|
|
22
|
+
Настройки собираются из нескольких слоев:
|
|
23
|
+
|
|
24
|
+
1. встроенные значения;
|
|
25
|
+
2. пользовательский файл `~/.iola/config.json`;
|
|
26
|
+
3. проектный файл `.iola/config.json`;
|
|
27
|
+
4. локальный файл `.iola/local.json`;
|
|
28
|
+
5. переменные окружения для runtime.
|
|
29
|
+
|
|
30
|
+
Команды:
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
iola settings list
|
|
34
|
+
iola settings get ai.activeProfile
|
|
35
|
+
iola settings validate
|
|
36
|
+
iola settings init
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## Subagents
|
|
40
|
+
|
|
41
|
+
Subagents позволяют запускать разные рабочие роли поверх тех же данных и AI-профилей:
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
iola subagents list
|
|
45
|
+
iola subagents run data-analyst "найди школы на Петрова"
|
|
46
|
+
iola subagents parallel data-analyst,reviewer "проверь результат"
|
|
47
|
+
iola subagents add culture --profile local --tools --prompt "Работай со слоями культуры Йошкар-Олы."
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
## Usage и budget
|
|
51
|
+
|
|
52
|
+
CLI пишет примерный учет запросов, символов, токенов и стоимости:
|
|
53
|
+
|
|
54
|
+
```bash
|
|
55
|
+
iola usage summary
|
|
56
|
+
iola usage models
|
|
57
|
+
iola usage sessions
|
|
58
|
+
iola budget set daily 5
|
|
59
|
+
iola budget status
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
Для локальной Ollama стоимость считается `0`, для внешних API используется грубая оценка, чтобы видеть порядок расходов.
|
|
63
|
+
|
|
64
|
+
## Sandbox и trajectory
|
|
65
|
+
|
|
66
|
+
Sandbox делает копию workspace для рискованных действий:
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
iola sandbox fork
|
|
70
|
+
iola sandbox run "npm test"
|
|
71
|
+
iola sandbox diff PATH
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
Trajectory export нужен для разбора действий агента:
|
|
75
|
+
|
|
76
|
+
```bash
|
|
77
|
+
iola trajectory last
|
|
78
|
+
iola trajectory export --format jsonl --output run.jsonl
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
## Hooks
|
|
82
|
+
|
|
83
|
+
Hooks можно запускать до и после tools, а также при ошибках:
|
|
84
|
+
|
|
85
|
+
```bash
|
|
86
|
+
iola hooks events
|
|
87
|
+
iola hooks add PreToolUse "iola trace last 5"
|
|
88
|
+
iola hooks add files_search:"iola memory add Поиск по файлам использовался"
|
|
89
|
+
iola hooks audit
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
События: `SessionStart`, `BeforeTool`, `AfterTool`, `PreToolUse`, `PostToolUse`, `OnError`, `AfterSync`, `BeforeExport`, `SessionEnd`.
|
|
93
|
+
|
|
94
|
+
## Review
|
|
95
|
+
|
|
96
|
+
Команды review дают быстрые проверки:
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
iola review config
|
|
100
|
+
iola review data
|
|
101
|
+
iola review docs ./docs
|
|
102
|
+
iola review report report.docx
|
|
103
|
+
```
|
|
104
|
+
|