@vint.tri/report_gen_mcp 1.7.27 → 1.7.28

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.
@@ -1,1029 +1,81 @@
1
- # ИСПРАВЛЕННЫЕ Инструкции для нейросети по работе с инструментом report_gen_mcp v1.5.9
1
+ # Финальные инструкции для нейросети по работе с инструментом report_gen_mcp v1.8.0
2
2
 
3
3
  **ВАЖНО:** ВСЕГДА ИСПОЛЬЗУЙТЕ ИНСТРУМЕНТ `report_gen_mcp` КАЖДЫЙ РАЗ, КОГДА ПОЛЬЗОВАТЕЛЬ ЗАПРАШИВАЕТ СОЗДАНИЕ ОТЧЕТА, ВИЗУАЛИЗАЦИЮ ДАННЫХ, ДИАГРАММУ, ГРАФИК ИЛИ ЛЮБОЕ ИЗМЕНЕНИЕ СУЩЕСТВУЮЩЕГО ОТЧЕТА!
4
4
 
5
- Этот документ содержит специальные инструкции для нейросети при работе с инструментом `report_gen_mcp`, чтобы обеспечить правильное взаимодействие с пользователем после генерации отчетов.
5
+ ## 1. Обязательное использование инструмента
6
6
 
7
- ## Обязательное использование инструмента
7
+ **КЛЮЧЕВОЕ ПРАВИЛО:** При любом запросе пользователя, связанном с созданием или изменением отчетов, диаграмм или графиков, вы **обязаны** использовать инструмент `report_gen_mcp`. Не пытайтесь создавать отчеты вручную.
8
8
 
9
- **КЛЮЧЕВОЕ ПРАВИЛО:** КАЖДЫЙ РАЗ, КОГДА ПОЛЬЗОВАТЕЛЬ ХОЧЕТ ПОЛУЧИТЬ ОТЧЕТ, ВИЗУАЛИЗАЦИЮ ДАННЫХ, ДИАГРАММУ, ГРАФИК, ИЛИ ПОПРОСИТЬ ЧТО-ЛИБО ДОБАВИТЬ/ИЗМЕНИТЬ В СУЩЕСТВУЮЩЕМ ОТЧЕТЕ, НЕЗАВИСИМО ОТ ФОРМАТА ЗАПРОСА, ВЫ ДОЛЖНЫ ИСПОЛЬЗОВАТЬ ИНСТРУМЕНТ `report_gen_mcp`!
9
+ ## 2. Требования к качеству отчетов
10
10
 
11
- НЕ пытайтесь создавать отчеты самостоятельно или предлагать пользователю делать это вручную. ВСЕГДА используйте инструмент `report_gen_mcp`.
11
+ Каждый сгенерированный отчет должен быть:
12
+ - **Информативным:** Содержать анализ данных, выводы и рекомендации.
13
+ - **Визуально насыщенным:** Включать **как минимум одну диаграмму и одно изображение**, релевантные теме отчета.
14
+ - **Красиво оформленным:** Использовать заголовки, списки и выделение текста для лучшей читаемости.
12
15
 
13
- ## Общие принципы работы
16
+ ## 3. Работа с файлами
14
17
 
15
- При использовании инструмента `report_gen_mcp` для генерации отчетов, нейросеть должна следовать определенному протоколу взаимодействия с пользователем, чтобы обеспечить полную и удобную работу с созданными отчетами.
18
+ - **Сохранение:** Все отчеты автоматически сохраняются в **системную временную директорию**. Вам не нужно указывать полный путь только имя файла в параметре `outputFile`.
19
+ - **Возврат данных:** Инструмент вернет вам полный путь к созданному файлу, который вы должны предоставить пользователю вместе со ссылками для просмотра.
16
20
 
17
- ## Поддерживаемые элементы отчета
21
+ ## 4. Формат параметров (КРИТИЧЕСКИ ВАЖНО!)
18
22
 
19
- Инструмент поддерживает вставку в отчеты следующих элементов:
20
- 1. **Диаграммы** (charts) - различные типы графиков (bar, line, pie, doughnut, radar, polarArea)
21
- 2. **Изображения** (images) - два типа:
22
- - Сгенерированные сервисом pollinations.ai по текстовому описанию
23
- - По URL из интернета
24
- - **ВАЖНО:** Локальные файлы на компьютере пользователя также поддерживаются, но они должны быть указаны как относительные пути или абсолютные пути в системе пользователя
23
+ ### 4.1. Параметр `elements`
25
24
 
26
- ## Требования к оформлению отчетов
25
+ - `elements` **ВСЕГДА** должен быть **ОБЪЕКТОМ**, а не строкой.
27
26
 
28
- При создании отчетов необходимо придерживаться следующих требований по оформлению:
27
+ - **НЕПРАВИЛЬНО:** `"elements": "{...}"`
28
+ - ✅ **ПРАВИЛЬНО:** `"elements": {...}`
29
29
 
30
- 1. **Красивое форматирование**:
31
- - Используйте заголовки разных уровней (H1, H2, H3) для структурирования контента
32
- - Добавляйте списки (маркированные и нумерованные) для лучшей читаемости
33
- - Используйте выделение важной информации (жирный шрифт, курсив)
34
- - Разделяйте смысловые блоки пустыми строками
30
+ ### 4.2. Параметры диаграмм (`charts`)
35
31
 
36
- 2. **Визуализация данных**:
37
- - Всегда добавляйте диаграммы для числовых данных
38
- - Выбирайте подходящий тип диаграммы в зависимости от характера данных
39
- - Добавляйте поясняющие подписи к диаграммам
40
- - Используйте разнообразные цвета для лучшей визуализации
41
- - **ВАЖНО**: Все диаграммы автоматически создаются с адекватными размерами (примерно 400x300 пикселей) для лучшего визуального восприятия и пропорциональности в отчете
42
- - Диаграммы автоматически оборачиваются в контейнеры с CSS классами для обеспечения правильного масштабирования и отступов
43
- - Все диаграммы должны быть интерактивными (с использованием Chart.js)
32
+ - **Массивы, массивы и еще раз массивы!**
33
+ - `labels`: **ВСЕГДА** массив строк. `["Январь"]`
34
+ - `data`: **ВСЕГДА** массив чисел. `[100]`
35
+ - `backgroundColor`: **ВСЕГДА** массив строк. `["red"]`
36
+ - `borderColor`: **ВСЕГДА** массив строк. `["blue"]`
37
+ - `options.title`: **ВСЕГДА** простая строка. `"Мой график"`
44
38
 
45
- 3. **Изображения**:
46
- - Добавляйте тематические изображения для иллюстрации контента
47
- - Используйте изображения высокого качества
48
- - Добавляйте альтернативный текст для изображений
49
- - При необходимости регулируйте размеры изображений
50
- - Каждый отчет должен содержать картинку, отражающую его суть
51
- - **ОСОБЕННОСТИ РАБОТЫ С ЛОКАЛЬНЫМИ ИЗОБРАЖЕНИЯМИ:**
52
- * При использовании локальных файлов изображений (file://) браузеры могут блокировать их отображение по соображениям безопасности
53
- * Для просмотра отчетов с локальными изображениями рекомендуется использовать Web link 2 (http://localhost:3000/...)
54
- * Альтернативно, пользователь может открыть файл напрямую в браузере через file:// ссылку
39
+ **Примечание:** Система теперь пытается автоматически исправлять некоторые ошибки форматирования (например, одиночные значения в массивы или парсинг строки `elements`), но для гарантированной работы **всегда** придерживайтесь правильного формата.
55
40
 
56
- 4. **Анализ данных**:
57
- - Каждый отчет должен содержать подробный анализ данных
58
- - Анализ должен включать выводы, закономерности и рекомендации
59
- - Используйте структурированный подход к анализу с выделением ключевых моментов
41
+ ## 5. Пример идеального вызова
60
42
 
61
- 5. **Сравнительные графики**:
62
- - Если отчет объединяет несколько сущностей, все их нужно отражать в одних и тех же сравнительных графиках
63
- - Используйте разные цвета и стили для различения сущностей на графиках
64
- - Добавляйте легенды и пояснения для лучшего понимания сравнительных данных
65
-
66
- 6. **Текстовое форматирование**:
67
- - Текст в отчетах автоматически форматируется с использованием HTML-разметки для улучшения читаемости
68
- - Отчеты имеют профессиональный внешний вид с улучшенным стилем, включая:
69
- * Четкую типографику с выравниванием текста по ширине
70
- * Стилизованные заголовки с цветовой индикацией
71
- * Улучшенное оформление списков и абзацев
72
- * Цветовое выделение важной информации (жирный шрифт красного цвета, курсив зеленого цвета)
73
- - Следите за форматированием текста, графиков и картинок - они не должны быть на весь экран
74
- - Все элементы должны быть оформлены в лучших традициях отчетности с соблюдением пропорций и отступов
75
-
76
- ## Работа с существующими отчетами
77
-
78
- Для работы с уже существующими отчетами доступен метод `read-report`, который позволяет нейросети прочитать содержимое отчета и использовать его для создания новых отчетов по запросу пользователя.
79
-
80
- **ВАЖНО:** Если пользователь просит изменить отчёт, добавить в него что-то, дополнить, расширить или отредактировать, то нейросеть сначала должна прочитать файл последнего отчета методом `report_gen_mcp : read-report`, затем создать новый файл отчета с добавлением нужного содержимого методом `report_gen_mcp : generate-report`. При этом следует использовать содержимое прочитанного отчета как основу для нового отчета, добавляя к нему запрошенные пользователем изменения.
81
-
82
- ### Метод read-report
83
-
84
- Метод `read-report` принимает путь к существующему HTML-отчету и возвращает его содержимое в структурированном виде, включая:
85
- - Заголовки и их уровни
86
- - Параграфы текста
87
- - Списки и их элементы
88
- - Информацию о диаграммах и изображениях
89
-
90
- После успешного чтения отчета с помощью метода `read-report`, нейросеть получает всю необходимую информацию напрямую в ответе от метода. Необходимо предоставить пользователю следующую информацию:
91
-
92
- 1. **Путь к файлу**: Абсолютный путь к прочитанному отчету
93
- 2. **Ссылка на файл**: Кликабельная file:// ссылка для открытия отчета в браузере
94
- 3. **Web link 2**: Ссылка вида http://localhost:3000/filename.html для доступа к отчету через веб-интерфейс
95
- 4. **Содержимое файла**: Полный текст HTML содержимого отчета
96
- 5. **Структурированное содержание**: Заголовки, параграфы, списки и элементы отчета
97
-
98
- ### После генерации нового отчета на основе существующего
99
-
100
- После успешной генерации нового отчета с помощью метода `generate-report`, нейросеть получает всю необходимую информацию напрямую в ответе от метода. Необходимо предоставить пользователю следующую информацию:
101
-
102
- ### 1. Предоставление информации пользователю
103
-
104
- Из ответа метода `generate-report` извлеките следующую информацию и предоставьте пользователю:
105
-
106
- 1. **Путь к файлу**: Абсолютный путь к созданному отчету
107
- 2. **Ссылка на файл**: Кликабельная file:// ссылка для открытия отчета в браузере
108
- 3. **Web link 2**: Ссылка вида http://localhost:3000/filename.html для доступа к отчету через веб-интерфейс
109
- 4. **Содержимое файла**: Полный текст HTML содержимого отчета
110
-
111
- Обязательно покажите пользователю содержимое файла, чтобы он мог сразу ознакомиться с результатом без необходимости открывать файл отдельно.
112
-
113
- **ВАЖНОЕ ТРЕБОВАНИЕ**: Отчет должен быть максимально красивым и качественным. Содержать **как минимум одну диаграмму и одно изображение**, а также выводы и рассуждения. Отчет должен быть строго в HTML формате!
114
-
115
- **ВАЖНО**: Всегда выводите Web link 2 как кликабельную ссылку в формате `[Web link 2](http://localhost:3000/filename.html)`!
116
-
117
- **ОСОБЕННОСТИ РАБОТЫ С ИЗОБРАЖЕНИЯМИ:**
118
- - Если отчет содержит локальные изображения (file://), они могут не отображаться при открытии через file:// ссылку из-за ограничений безопасности браузера
119
- - Для корректного отображения всех изображений рекомендуется использовать Web link 2 (http://localhost:3000/...)
120
- - Пользователь также может открыть файл напрямую в браузере через file:// ссылку, если браузер позволяет загрузку локальных ресурсов
121
-
122
- Пример формата ответа пользователю:
123
- ```
124
- Отчет успешно создан!
125
-
126
- 📁 Путь к файлу: /полный/путь/к/отчету.html
127
- 🌐 Ссылка для открытия в браузере: file:///полный/путь/к/отчету.html
128
- 🔗 [Web link 2](http://localhost:3000/отчет.html)
129
-
130
- 📄 Содержимое отчета:
131
- <!DOCTYPE html>
132
- <html lang="ru">
133
- <head>
134
- <meta charset="UTF-8">
135
- <title>Отчет</title>
136
- <style>
137
- body {
138
- font-family: Arial, sans-serif;
139
- margin: 40px;
140
- background-color: #f5f5f5;
141
- }
142
- .container {
143
- max-width: 1200px;
144
- margin: 0 auto;
145
- background-color: white;
146
- padding: 30px;
147
- border-radius: 10px;
148
- box-shadow: 0 0 10px rgba(0,0,0,0.1);
149
- }
150
- h1, h2, h3 {
151
- color: #333;
152
- }
153
- h1 {
154
- border-bottom: 2px solid #3498db;
155
- padding-bottom: 10px;
156
- }
157
- h2 {
158
- border-left: 4px solid #3498db;
159
- padding-left: 15px;
160
- }
161
- .chart-container, .image-container {
162
- margin: 30px 0;
163
- text-align: center;
164
- }
165
- .chart-container canvas, .image-container img {
166
- max-width: 100%;
167
- height: auto;
168
- border: 1px solid #ddd;
169
- border-radius: 5px;
170
- }
171
- p {
172
- line-height: 1.6;
173
- text-align: justify;
174
- }
175
- ul, ol {
176
- margin: 20px 0;
177
- padding-left: 30px;
178
- }
179
- li {
180
- margin: 10px 0;
181
- }
182
- strong {
183
- color: #e74c3c;
184
- }
185
- em {
186
- color: #2ecc71;
187
- }
188
- </style>
189
- <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
190
- </head>
191
- <body>
192
- <div class="container">
193
- <h1>Отчет</h1>
194
- <div class="chart-container">
195
- <!-- Chart.js chart code -->
196
- </div>
197
- <div class="image-container">
198
- <!-- Generated image -->
199
- <img src="https://image.pollinations.ai/prompt/красивый%20закат" alt="красивый закат">
200
- </div>
201
- <h2>Анализ данных</h2>
202
- <p>На основании проведенного анализа можно сделать следующие выводы:</p>
203
- <ul>
204
- <li><strong>Основной тренд:</strong> наблюдается положительная динамика роста</li>
205
- <li><strong>Сезонность:</strong> наиболее высокие показатели наблюдаются во второй половине периода</li>
206
- <li><strong>Прогноз:</strong> ожидается продолжение роста в ближайшие месяцы</li>
207
- </ul>
208
- <h2>Рекомендации</h2>
209
- <ol>
210
- <li>Увеличить инвестиции в направления с высокой доходностью</li>
211
- <li>Оптимизировать расходы в менее эффективных сегментах</li>
212
- <li>Рассмотреть возможность расширения бизнеса</li>
213
- </ol>
214
- </div>
215
- </body>
216
- </html>
217
-
218
- 💡 Примечание: Если изображения не отображаются, попробуйте открыть отчет по Web link 2, который обеспечивает корректное отображение всех элементов.
219
-
220
- Вы можете открыть отчет, кликнув на ссылку выше или скопировав путь к файлу.
221
- ```
222
-
223
- ### 2. Альтернативный подход (при необходимости)
224
-
225
- Если по какой-то причине информация не была получена напрямую из метода `generate-report`, можно использовать дополнительные инструменты:
226
-
227
- #### Получение информации о файле
228
-
229
- Используйте инструмент `get-report-url` для получения полной информации о созданном отчете:
230
-
231
- ```json
232
- {
233
- "method": "tools/call",
234
- "params": {
235
- "name": "get-report-url",
236
- "arguments": {
237
- "filePath": "/путь/к/созданному/отчету.html"
238
- }
239
- }
240
- }
241
- ```
242
-
243
- #### Прикрепление содержимого файла
244
-
245
- Для того чтобы пользователь мог сразу просмотреть содержимое отчета без необходимости открывать файл, используйте инструмент `get-report-file`:
246
-
247
- ```json
248
- {
249
- "method": "tools/call",
250
- "params": {
251
- "name": "get-report-file",
252
- "arguments": {
253
- "filePath": "/путь/к/созданному/отчету.html"
254
- }
255
- }
256
- }
257
- ```
258
-
259
- ### 3. Особенности работы с изображениями
260
-
261
- При генерации изображений с помощью инструментов `generate-image` или `edit-image`, нейросеть должна:
262
-
263
- 1. **Для `generate-image`** - обрабатывать ответ, содержащий:
264
- - Текстовое подтверждение генерации
265
- - Путь к файлу изображения на диске
266
- - File URL для открытия в браузере: `file:///полный/путь/к/файлу.jpg`
267
- - Web link 2: `http://localhost:3000/имя_файла.jpg`
268
- - **img_link**: `http://localhost:3000/имя_файла.jpg` (предпочтительная ссылка для использования во всех отчетах)
269
-
270
- 2. **Для `edit-image`** - обрабатывать ответ, содержащий:
271
- - Текстовое подтверждение редактирования
272
- - Путь к файлу изображения на диске
273
- - File URL для открытия в браузере: `file:///полный/путь/к/файлу.jpg`
274
- - Web link 2: `http://localhost:3000/имя_файла.jpg`
275
- - **img_link**: `http://localhost:3000/имя_файла.jpg` (предпочтительная ссылка для использования во всех отчетах)
276
-
277
- 3. **Важно**: Всегда показывайте пользователю Web link 2 для быстрого доступа к изображению через веб-интерфейс.
278
-
279
- 4. **ВАЖНО**: Всегда выводите Web link 2 как кликабельную ссылку в формате `[Web link 2](http://localhost:3000/filename.jpg)`!
280
-
281
- 5. **ОСОБЕННО ВАЖНО**: При генерации изображения обязательно прикладывайте путь к нему в виде https или http ссылки (img_link). Именно эту ссылку предпочтительнее всего использовать во всех отчетах!
282
-
283
- 6. **Пример корректного ответа при генерации изображения**:
284
- ```
285
- ✅ Изображение успешно сгенерировано по промпту: 'beautiful landscape'
286
-
287
- 📁 Файл сохранен: /полный/путь/к/generated-image-1234567890.jpeg
288
- 🌐 Web link: file:///полный/путь/к/generated-image-1234567890.jpeg
289
- 🔗 [Web link 2](http://localhost:3000/generated-image-1234567890.jpeg)
290
- 🖼️ img_link: http://localhost:3000/generated-image-1234567890.jpeg (предпочтительная ссылка для использования в отчетах)
291
-
292
- 💡 Примечание: Если изображение не отображается, попробуйте открыть его по Web link 2, который обеспечивает корректное отображение.
293
-
294
- Вы можете открыть изображение, кликнув на ссылку выше или скопировав путь к файлу.
295
- ```
296
-
297
- 7. **Пример корректного ответа при редактировании изображения**:
298
- ```
299
- ✅ Изображение успешно отредактировано по промпту: 'add a hat to the person'
300
-
301
- 📁 Файл сохранен: /полный/путь/к/edited-image-1234567890.jpeg
302
- 🌐 Web link: file:///полный/путь/к/edited-image-1234567890.jpeg
303
- 🔗 [Web link 2](http://localhost:3000/edited-image-1234567890.jpeg)
304
- 🖼️ img_link: http://localhost:3000/edited-image-1234567890.jpeg (предпочтительная ссылка для использования в отчетах)
305
-
306
- 💡 Примечание: Если изображение не отображается, попробуйте открыть его по Web link 2, который обеспечивает корректное отображение.
307
-
308
- Вы можете открыть изображение, кликнув на ссылку выше или скопировав путь к файлу.
309
- ```
310
-
311
- ## Формат данных для диаграмм (графиков)
312
-
313
- Очень важно правильно формировать данные для диаграмм, чтобы избежать ошибок. Ниже приведены точные требования к формату данных для каждого типа диаграмм.
314
-
315
- ### Общие правила для всех типов диаграмм
316
-
317
- 1. Все цветовые значения (`backgroundColor`, `borderColor`) должны быть представлены в виде **массивов строк**, даже если это один цвет.
318
- 2. Все числовые данные (`data`) должны быть представлены в виде массивов чисел.
319
- 3. Все текстовые метки (`labels`) должны быть представлены в виде массивов строк.
320
- 4. Значение `options.title` должно быть **строкой**, а не объектом.
321
-
322
- ### Линейные диаграммы (line)
323
-
324
- ```json
325
- {
326
- "type": "line",
327
- "config": {
328
- "labels": ["Январь", "Февраль", "Март", "Апрель", "Май"],
329
- "datasets": [
330
- {
331
- "label": "Продажи (USD)",
332
- "data": [12000, 19000, 15000, 18000, 22000],
333
- "borderColor": ["rgba(54, 162, 235, 1)"], // ВАЖНО: массив, даже для одного цвета!
334
- "fill": false
335
- }
336
- ],
337
- "options": {
338
- "title": "Ежемесячные продажи"
339
- }
340
- }
341
- }
342
- ```
343
-
344
- **Важно**: `borderColor` должен быть массивом строк, даже если используется только один цвет.
345
-
346
- ### Столбчатые диаграммы (bar)
347
-
348
- ```json
349
- {
350
- "type": "bar",
351
- "config": {
352
- "labels": ["Январь", "Февраль", "Март", "Апрель", "Май"],
353
- "datasets": [
354
- {
355
- "label": "Продажи (USD)",
356
- "data": [12000, 19000, 15000, 18000, 22000],
357
- "backgroundColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0", "#9966FF"], // Массив цветов
358
- "borderColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0", "#9966FF"] // Массив цветов
359
- }
360
- ],
361
- "options": {
362
- "title": "Ежемесячные продажи"
363
- }
364
- }
365
- }
366
- ```
367
-
368
- **Важно**: `backgroundColor` и `borderColor` должны быть массивами строк, даже если используется только один цвет.
369
-
370
- ### Круговые диаграммы (pie)
371
-
372
- ```json
373
- {
374
- "type": "pie",
375
- "config": {
376
- "labels": ["Красный", "Синий", "Желтый", "Зеленый", "Фиолетовый"],
377
- "datasets": [
378
- {
379
- "data": [12, 19, 3, 5, 2],
380
- "backgroundColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0", "#9966FF"], // Массив цветов
381
- "borderColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0", "#9966FF"] // Массив цветов
382
- }
383
- ],
384
- "options": {
385
- "title": "Распределение по категориям"
386
- }
387
- }
388
- }
389
- ```
390
-
391
- **Важно**: `backgroundColor` и `borderColor` должны быть массивами строк, даже если используется только один цвет.
392
-
393
- ### Кольцевые диаграммы (doughnut)
394
-
395
- ```json
396
- {
397
- "type": "doughnut",
398
- "config": {
399
- "labels": ["Красный", "Синий", "Желтый", "Зеленый", "Фиолетовый"],
400
- "datasets": [
401
- {
402
- "data": [12, 19, 3, 5, 2],
403
- "backgroundColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0", "#9966FF"], // Массив цветов
404
- "borderColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0", "#9966FF"] // Массив цветов
405
- }
406
- ],
407
- "options": {
408
- "title": "Распределение по категориям"
409
- }
410
- }
411
- }
412
- ```
413
-
414
- **Важно**: `backgroundColor` и `borderColor` должны быть массивами строк, даже если используется только один цвет.
415
-
416
- ### Радарные диаграммы (radar)
417
-
418
- ```json
419
- {
420
- "type": "radar",
421
- "config": {
422
- "labels": ["Eating", "Drinking", "Sleeping", "Designing", "Coding", "Cycling", "Running"],
423
- "datasets": [
424
- {
425
- "label": "Person 1",
426
- "data": [65, 59, 90, 81, 56, 55, 40],
427
- "backgroundColor": ["rgba(255, 99, 132, 0.2)"], // Массив цветов
428
- "borderColor": ["rgba(255, 99, 132, 1)"] // Массив цветов
429
- }
430
- ],
431
- "options": {
432
- "title": "Радарная диаграмма"
433
- }
434
- }
435
- }
436
- ```
437
-
438
- **Важно**: `backgroundColor` и `borderColor` должны быть массивами строк, даже если используется только один цвет.
439
-
440
- ### Полярные диаграммы (polarArea)
441
-
442
- ```json
443
- {
444
- "type": "polarArea",
445
- "config": {
446
- "labels": ["Red", "Green", "Yellow", "Grey", "Blue"],
447
- "datasets": [
448
- {
449
- "data": [11, 16, 7, 3, 14],
450
- "backgroundColor": ["#FF6384", "#4BC0C0", "#FFCE56", "#E7E9ED", "#36A2EB"], // Массив цветов
451
- "borderColor": ["#FF6384", "#4BC0C0", "#FFCE56", "#E7E9ED", "#36A2EB"] // Массив цветов
452
- }
453
- ],
454
- "options": {
455
- "title": "Полярная диаграмма"
456
- }
457
- }
458
- }
459
- ```
460
-
461
- **Важно**: `backgroundColor` и `borderColor` должны быть массивами строк.
462
-
463
- ## Формат данных для изображений
464
-
465
- ### Изображения, сгенерированные pollinations.ai
466
-
467
- ```json
468
- {
469
- "type": "pollinations",
470
- "config": {
471
- "prompt": "красивый закат над океаном",
472
- "width": 512,
473
- "height": 512,
474
- "model": "flux",
475
- "seed": 12345,
476
- "nologo": true,
477
- "enhance": true
478
- }
479
- }
480
- ```
481
-
482
- ### Изображения, сгенерированные с помощью generate-image (Chutes AI)
483
-
484
- При использовании инструмента `generate-image` для генерации изображений с помощью Chutes AI, числовые параметры могут быть представлены как числа или как строки. Инструмент автоматически преобразует строковые параметры в числа.
485
-
486
- ✅ ПРИМЕР 1 (числовые параметры как числа):
487
- ```json
488
- {
489
- "method": "tools/call",
490
- "params": {
491
- "name": "generate-image",
492
- "arguments": {
493
- "prompt": "a dog made of US dollar bills",
494
- "width": 512,
495
- "height": 512,
496
- "guidance_scale": 7.5,
497
- "negative_prompt": "blurry, low quality",
498
- "num_inference_steps": 50,
499
- "seed": 0
500
- }
501
- }
502
- }
503
- ```
504
-
505
- ✅ ПРИМЕР 2 (числовые параметры как строки):
506
- ```json
507
- {
508
- "method": "tools/call",
509
- "params": {
510
- "name": "generate-image",
511
- "arguments": {
512
- "prompt": "a dog made of US dollar bills",
513
- "width": "512",
514
- "height": "512",
515
- "guidance_scale": "7.5",
516
- "negative_prompt": "blurry, low quality",
517
- "num_inference_steps": "50",
518
- "seed": "0"
519
- }
520
- }
521
- }
522
- ```
523
-
524
- ✅ ПРИМЕР 3 (смешанные параметры):
525
- ```json
526
- {
527
- "method": "tools/call",
528
- "params": {
529
- "name": "generate-image",
530
- "arguments": {
531
- "prompt": "a dog made of US dollar bills",
532
- "width": "512",
533
- "height": 512,
534
- "guidance_scale": "7.5",
535
- "negative_prompt": "blurry, low quality",
536
- "num_inference_steps": 50,
537
- "seed": "0"
538
- }
539
- }
540
- }
541
- ```
542
-
543
- **Гибкость параметров:** Инструмент поддерживает как числовые, так и строковые значения для числовых параметров (`width`, `height`, `guidance_scale`, `num_inference_steps`, `seed`). Это обеспечивает совместимость с различными способами формирования запросов.
544
-
545
- **ПРАВИЛЬНОЕ ИСПОЛЬЗОВАНИЕ РЕЗУЛЬТАТА generate-image В ОТЧЕТАХ:**
546
-
547
- Когда вы получаете ответ от `generate-image`, он имеет следующую структуру:
548
- ```json
549
- {
550
- "content": [
551
- {
552
- "type": "text",
553
- "text": "✅ Image successfully generated from prompt: 'your prompt'"
554
- }
555
- ],
556
- "filePath": "/полный/путь/к/generated-image-1234567890.jpeg",
557
- "fileUrl": "file:///полный/путь/к/generated-image-1234567890.jpeg"
558
- }
559
- ```
560
-
561
- Чтобы использовать это изображение в отчете с помощью `generate-report`, извлеките `fileUrl` из ответа и используйте его в элементе отчета:
562
-
563
- ```json
564
- {
565
- "method": "tools/call",
566
- "params": {
567
- "name": "generate-report",
568
- "arguments": {
569
- "document": "# Отчет\n\n[[image:generated_img]]",
570
- "elements": {
571
- "generated_img": {
572
- "type": "url",
573
- "config": {
574
- "url": "file:///полный/путь/к/generated-image-1234567890.jpeg", // <- Используйте fileUrl из предыдущего ответа
575
- "alt": "Сгенерированное изображение",
576
- "width": 512,
577
- "height": 512
578
- }
579
- }
580
- },
581
- "outputFile": "report.html"
582
- }
583
- }
584
- }
585
- ```
586
-
587
- ### Изображения по URL
588
-
589
- ```json
590
- {
591
- "type": "url",
592
- "config": {
593
- "url": "https://example.com/image.jpg",
594
- "alt": "Описание изображения",
595
- "width": 500,
596
- "height": 300
597
- }
598
- }
599
- ```
600
-
601
- ### Локальные изображения (по файловому пути)
602
-
603
- ```json
604
- {
605
- "type": "url",
606
- "config": {
607
- "url": "file:///полный/путь/к/изображению.jpg",
608
- "alt": "Описание изображения",
609
- "width": 500,
610
- "height": 300
611
- }
612
- }
613
- ```
614
-
615
- **ВАЖНО ПРИ РАБОТЕ С ЛОКАЛЬНЫМИ ИЗОБРАЖЕНИЯМИ:**
616
- - Локальные изображения должны быть указаны с полным путем в формате file://
617
- - Браузеры могут блокировать отображение локальных файлов по соображениям безопасности
618
- - Для корректного отображения используйте Web link 2 (http://localhost:3000/...)
619
-
620
- ## ПРАВИЛА ФОРМАТИРОВАНИЯ ПАРАМЕТРОВ (КРИТИЧЕСКИ ВАЖНО!)
621
-
622
- ### 1. ПАРАМЕТР "elements" ДОЛЖЕН БЫТЬ ОБЪЕКТОМ!
623
-
624
- ❌ НЕПРАВИЛЬНО (это вызывает ошибку "Expected object, received string"):
625
- ```json
626
- {
627
- "method": "generate-report",
628
- "params": {
629
- "document": "# Отчет\n\n[[chart:mychart]]",
630
- "elements": "{ \"mychart\": { \"type\": \"bar\", \"config\": { \"labels\": [\"A\", \"B\", \"C\"], \"datasets\": [{ \"label\": \"Data\", \"data\": [1, 2, 3], \"backgroundColor\": [\"red\", \"green\", \"blue\"], \"borderColor\": [\"red\", \"green\", \"blue\"] }] } }",
631
- "outputFile": "report.html"
632
- }
633
- }
634
- ```
635
-
636
- ✅ ПРАВИЛЬНО (elements - это объект, а не строка):
637
43
  ```json
638
44
  {
639
45
  "method": "generate-report",
640
46
  "params": {
641
- "document": "# Отчет\n\n[[chart:mychart]]",
47
+ "document": "# Отчет о продажах\n\nАнализ квартальных продаж.\n\n[[chart:sales]]\n\n![бизнес-успех]([[image:success]])",
642
48
  "elements": {
643
- "mychart": {
49
+ "sales": {
644
50
  "type": "bar",
645
51
  "config": {
646
- "labels": ["A", "B", "C"],
52
+ "labels": ["Q1", "Q2", "Q3", "Q4"],
647
53
  "datasets": [{
648
- "label": "Data",
649
- "data": [1, 2, 3],
650
- "backgroundColor": ["red", "green", "blue"],
651
- "borderColor": ["red", "green", "blue"]
54
+ "label": "Продажи 2024",
55
+ "data": [120, 150, 130, 180],
56
+ "backgroundColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0"]
652
57
  }],
653
58
  "options": {
654
- "title": "Мой график"
655
- }
656
- }
657
- }
658
- },
659
- "outputFile": "report.html"
660
- }
661
- }
662
- ```
663
-
664
- ### 2. ЦВЕТОВЫЕ ЗНАЧЕНИЯ ДОЛЖНЫ БЫТЬ МАССИВАМИ!
665
-
666
- ❌ НЕПРАВИЛЬНО (это вызывает ошибку):
667
- ```json
668
- "backgroundColor": "red"
669
- "borderColor": "blue"
670
- ```
671
-
672
- ✅ ПРАВИЛЬНО (всегда используйте массивы):
673
- ```json
674
- "backgroundColor": ["red"]
675
- "borderColor": ["blue"]
676
- ```
677
-
678
- ### 3. ЧИСЛОВЫЕ ДАННЫЕ ДОЛЖНЫ БЫТЬ МАССИВАМИ!
679
-
680
- ❌ НЕПРАВИЛЬНО (это вызовет ошибку валидации):
681
- ```json
682
- "data": 10
683
- ```
684
-
685
- ✅ ПРАВИЛЬНО (даже для одного значения):
686
- ```json
687
- "data": [10]
688
- ```
689
-
690
- **КРИТИЧЕСКИ ВАЖНО:** Всегда оборачивайте числовые данные для диаграмм в массив. Хотя система теперь пытается исправлять некоторые ошибки, правильный формат гарантирует стабильную работу.
691
-
692
- ### 4. ТЕКСТОВЫЕ МЕТКИ ДОЛЖНЫ БЫТЬ МАССИВАМИ!
693
-
694
- ❌ НЕПРАВИЛЬНО (это вызовет ошибку валидации):
695
- ```json
696
- "labels": "Январь"
697
- ```
698
-
699
- ✅ ПРАВИЛЬНО (даже для одной метки):
700
- ```json
701
- "labels": ["Январь"]
702
- ```
703
-
704
- **КРИТИЧЕСКИ ВАЖНО:** Всегда оборачивайте текстовые метки для диаграмм в массив. Хотя система теперь пытается исправлять некоторые ошибки, правильный формат гарантирует стабильную работу.
705
-
706
- ### 5. ЗНАЧЕНИЕ options.title ДОЛЖНО БЫТЬ СТРОКОЙ!
707
-
708
- ❌ НЕПРАВИЛЬНО (это вызывает ошибку):
709
- ```json
710
- "options": {
711
- "title": {
712
- "text": "Заголовок графика"
713
- }
714
- }
715
- ```
716
-
717
- ✅ ПРАВИЛЬНО:
718
- ```json
719
- "options": {
720
- "title": "Заголовок графика"
721
- }
722
- ```
723
-
724
- ### 6. ТИП ЭЛЕМЕНТА ДОЛЖЕН СООТВЕТСТВОВАТЬ ЕГО СОДЕРЖИМОМУ!
725
-
726
- ❌ НЕПРАВИЛЬНО (это вызывает ошибку):
727
- ```json
728
- "comparison_chart": {
729
- "type": "bar", // Неправильный тип для сравнения - должен быть либо "pollinations", либо "url"
730
- "config": {
731
- "labels": ["A", "B", "C"],
732
- "datasets": [{
733
- "label": "Data",
734
- "data": [1, 2, 3],
735
- "backgroundColor": ["red", "green", "blue"]
736
- }]
737
- }
738
- }
739
- ```
740
-
741
- ✅ ПРАВИЛЬНО (для диаграмм):
742
- ```json
743
- "comparison_chart": {
744
- "type": "bar",
745
- "config": {
746
- "labels": ["A", "B", "C"],
747
- "datasets": [{
748
- "label": "Data",
749
- "data": [1, 2, 3],
750
- "backgroundColor": ["red", "green", "blue"]
751
- }],
752
- "options": {
753
- "title": "Сравнительная диаграмма"
754
- }
755
- }
756
- }
757
- ```
758
-
759
- ✅ ПРАВИЛЬНО (для изображений):
760
- ```json
761
- "comparison_chart": {
762
- "type": "pollinations",
763
- "config": {
764
- "prompt": "beautiful landscape with mountains",
765
- "width": 600,
766
- "height": 400
767
- }
768
- }
769
- ```
770
-
771
- ✅ ПРАВИЛЬНО (для локальных изображений):
772
- ```json
773
- "comparison_chart": {
774
- "type": "url",
775
- "config": {
776
- "url": "file:///полный/путь/к/изображению.jpg",
777
- "alt": "Локальное изображение",
778
- "width": 500,
779
- "height": 300
780
- }
781
- }
782
- ```
783
-
784
- ## Пример полного взаимодействия
785
-
786
- Вот пример того, как должно выглядеть полное взаимодействие с пользователем после генерации отчета:
787
-
788
- 1. Генерация отчета с диаграммами:
789
- ```json
790
- {
791
- "method": "generate-report",
792
- "params": {
793
- "document": "# Отчет\n\n[[chart:sales_chart]]\n\n[[chart:comparison_chart]]",
794
- "elements": {
795
- "sales_chart": {
796
- "type": "bar",
797
- "config": {
798
- "labels": ["Январь", "Февраль", "Март", "Апрель", "Май"],
799
- "datasets": [{
800
- "label": "Продажи (USD)",
801
- "data": [12000, 19000, 15000, 18000, 22000],
802
- "backgroundColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0", "#9966FF"],
803
- "borderColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0", "#9966FF"]
804
- }],
805
- "options": {
806
- "title": "Ежемесячные продажи"
59
+ "title": "Квартальные продажи"
807
60
  }
808
61
  }
809
62
  },
810
- "comparison_chart": {
811
- "type": "pie",
812
- "config": {
813
- "labels": ["Категория A", "Категория B", "Категория C"],
814
- "datasets": [{
815
- "data": [30, 50, 20],
816
- "backgroundColor": ["#FF6384", "#36A2EB", "#FFCE56"],
817
- "borderColor": ["#FF6384", "#36A2EB", "#FFCE56"]
818
- }],
819
- "options": {
820
- "title": "Сравнение по категориям"
821
- }
822
- }
823
- }
824
- },
825
- "outputFile": "report.html"
826
- }
827
- }
828
- ```
829
-
830
- 2. Генерация отчета с изображениями:
831
- ```json
832
- {
833
- "method": "generate-report",
834
- "params": {
835
- "document": "# Отчет\n\n[[image:main_image]]\n\n[[image:comparison_image]]\n\n[[image:local_image]]",
836
- "elements": {
837
- "main_image": {
63
+ "success": {
838
64
  "type": "pollinations",
839
65
  "config": {
840
- "prompt": "beautiful landscape with mountains and lake",
841
- "width": 600,
842
- "height": 400,
843
- "model": "flux",
844
- "nologo": true,
845
- "enhance": true
846
- }
847
- },
848
- "comparison_image": {
849
- "type": "url",
850
- "config": {
851
- "url": "https://example.com/comparison-diagram.jpg",
852
- "alt": "Сравнительная диаграмма",
853
- "width": 500,
854
- "height": 300
855
- }
856
- },
857
- "local_image": {
858
- "type": "url",
859
- "config": {
860
- "url": "file:///полный/путь/к/local-image.jpg",
861
- "alt": "Локальное изображение",
862
- "width": 500,
863
- "height": 300
66
+ "prompt": "график роста и успеха в бизнесе"
864
67
  }
865
68
  }
866
69
  },
867
- "outputFile": "report.html"
70
+ "outputFile": "sales_report.html"
868
71
  }
869
72
  }
870
73
  ```
871
74
 
872
- 3. Ответ от метода `generate-report` уже содержит всю необходимую информацию:
873
- ```json
874
- {
875
- "content": [
876
- {
877
- "type": "text",
878
- "text": "Report generated successfully.\n\nFOR THE NEURAL NETWORK: Please present the following information to the user:\n1. Path to file: /path/to/report.html\n2. Web browser link: file:///path/to/report.html\n3. Web link 2: http://localhost:3000/report.html"
879
- }
880
- ]
881
- }
882
- ```
883
-
884
- 4. Ответ пользователю (на основе информации из ответа метода):
885
- ```
886
- Отчет успешно создан!
887
-
888
- 📁 Путь к файлу: /path/to/report.html
889
- 🌐 Ссылка для открытия в браузере: file:///path/to/report.html
890
- 🔗 [Web link 2](http://localhost:3000/report.html)
891
-
892
- 💡 Примечание: Если изображения не отображаются, попробуйте открыть отчет по Web link 2, который обеспечивает корректное отображение всех элементов, включая локальные изображения.
893
-
894
- Содержимое отчета:
895
- <!DOCTYPE html>
896
- <html lang="ru">
897
- <head>
898
- <meta charset="UTF-8">
899
- <title>Отчет</title>
900
- <style>
901
- body {
902
- font-family: Arial, sans-serif;
903
- margin: 40px;
904
- background-color: #f5f5f5;
905
- }
906
- .container {
907
- max-width: 1200px;
908
- margin: 0 auto;
909
- background-color: white;
910
- padding: 30px;
911
- border-radius: 10px;
912
- box-shadow: 0 0 10px rgba(0,0,0,0.1);
913
- }
914
- h1, h2, h3 {
915
- color: #333;
916
- }
917
- h1 {
918
- border-bottom: 2px solid #3498db;
919
- padding-bottom: 10px;
920
- }
921
- h2 {
922
- border-left: 4px solid #3498db;
923
- padding-left: 15px;
924
- }
925
- .chart-container, .image-container {
926
- margin: 30px 0;
927
- text-align: center;
928
- }
929
- .chart-container canvas, .image-container img {
930
- max-width: 100%;
931
- height: auto;
932
- border: 1px solid #ddd;
933
- border-radius: 5px;
934
- }
935
- p {
936
- line-height: 1.6;
937
- text-align: justify;
938
- }
939
- ul, ol {
940
- margin: 20px 0;
941
- padding-left: 30px;
942
- }
943
- li {
944
- margin: 10px 0;
945
- }
946
- strong {
947
- color: #e74c3c;
948
- }
949
- em {
950
- color: #2ecc71;
951
- }
952
- </style>
953
- <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
954
- </head>
955
- <body>
956
- <div class="container">
957
- <h1>Отчет</h1>
958
- <div class="chart-container">
959
- <!-- Chart.js chart code -->
960
- </div>
961
- <div class="image-container">
962
- <!-- Generated image -->
963
- <img src="https://image.pollinations.ai/prompt/beautiful%20landscape%20with%20mountains%20and%20lake" alt="beautiful landscape with mountains and lake">
964
- </div>
965
- <h2>Анализ данных</h2>
966
- <p>На основании проведенного анализа можно сделать следующие выводы:</p>
967
- <ul>
968
- <li><strong>Основной тренд:</strong> наблюдается положительная динамика роста</li>
969
- <li><strong>Сезонность:</strong> наиболее высокие показатели наблюдаются во второй половине периода</li>
970
- <li><strong>Прогноз:</strong> ожидается продолжение роста в ближайшие месяцы</li>
971
- </ul>
972
- <h2>Рекомендации</h2>
973
- <ol>
974
- <li>Увеличить инвестиции в направления с высокой доходностью</li>
975
- <li>Оптимизировать расходы в менее эффективных сегментах</li>
976
- <li>Рассмотреть возможность расширения бизнеса</li>
977
- </ol>
978
- </div>
979
- </body>
980
- </html>
981
-
982
- Вы можете открыть отчет, кликнув на ссылку выше или скопировав путь к файлу.
983
- ```
984
-
985
- ## Частые ошибки и как их избежать
986
-
987
- 1. **Ошибка формата параметров**: Передача `elements` как строки вместо объекта
988
- - ❌ Неправильно: `"elements": "{\"mychart\":{...}}"`
989
- - ✅ Правильно: `"elements": {"mychart":{...}}"
990
-
991
- 2. **Ошибка формата цвета**: Передача `borderColor` или `backgroundColor` как строк вместо массивов
992
- - ❌ Неправильно: `"borderColor": "red"`
993
- - ✅ Правильно: `"borderColor": ["red"]"
994
-
995
- 3. **Ошибка формата данных**: Передача числовых данных как отдельных значений вместо массивов
996
- - ❌ Неправильно: `"data": 10
997
- - ✅ Правильно: `"data": [10]"
998
-
999
- 4. **Ошибка формата меток**: Передача меток как отдельных значений вместо массивов
1000
- - ❌ Неправильно: `"labels": "Январь"
1001
- - ✅ Правильно: `"labels": ["Январь"]"
1002
-
1003
- 5. **Ошибка формата заголовка**: Передача `options.title` как объекта вместо строки
1004
- - ❌ Неправильно: `"options": {"title": {"text": "Заголовок"}}`
1005
- - ✅ Правильно: `"options": {"title": "Заголовок"}`
1006
-
1007
- 6. **Ошибка типа элемента**: Использование неправильного типа для элемента
1008
- - ❌ Неправильно: `"type": "bar"` для изображения
1009
- - ✅ Правильно: `"type": "pollinations"` или `"type": "url"` для изображений
1010
-
1011
- 7. **Ошибка с локальными изображениями**: Неправильный формат file:// URL
1012
- - ❌ Неправильно: `"url": "/путь/к/изображению.jpg"`
1013
- - ✅ Правильно: `"url": "file:///полный/путь/к/изображению.jpg"`
1014
-
1015
- ## Дополнительные рекомендации
1016
-
1017
- 1. Всегда проверяйте успешность выполнения каждой операции перед переходом к следующему шагу
1018
- 2. Если какой-либо шаг завершается ошибкой, сообщите пользователю об этом и предложите решение
1019
- 3. Убедитесь, что все пути к файлам корректны и файлы действительно существуют
1020
- 4. **Сохранение файлов**: Все отчеты автоматически сохраняются в системную временную директорию. Вам не нужно указывать путь, просто передайте имя файла в `outputFile`. Инструмент вернет полный путь к сохраненному файлу.
1021
- 5. Создавайте отчеты с красивым оформлением, используя заголовки, списки и другие элементы форматирования
1022
- 6. Добавляйте в отчеты диаграммы и изображения для лучшей визуализации данных
1023
- 7. Всегда после генерации отчета возвращайте пользователю ссылку на файл отчета, путь к файлу отчета и содержимое файла
1024
- 8. Отчет должен быть максимально красивым и качественным, содержать изображения, графики, выводы и рассуждения
1025
- 9. Отчет должен быть строго в HTML формате
1026
- 10. **ВАЖНО**: Всегда выводите Web link 2 как кликабельную ссылку в формате `[Web link 2](http://localhost:3000/filename.html)`!
1027
- 11. **ОСОБЕННО ВАЖНО**: При использовании локальных изображений всегда добавляйте примечание о том, что для корректного отображения следует использовать Web link 2
75
+ ## 6. Ответ пользователю
1028
76
 
1029
- Следование этим инструкциям обеспечит качественное и полное взаимодействие с пользователем при работе с инструментом генерации отчетов.
77
+ После успешной генерации отчета предоставьте пользователю:
78
+ 1. **Путь к файлу** (из ответа инструмента).
79
+ 2. **Ссылку `file://`** для локального открытия.
80
+ 3. **Ссылку `http://localhost:3000/...`** (Web link 2) для надежного отображения всех элементов.
81
+ 4. **Полное содержимое HTML-файла**.