Встроенный браузер¶

Koda Desktop умеет открывать веб-страницы прямо в окне приложения. Агент пользуется ими как инструментом: открывает сайт, читает содержимое, нажимает кнопки и заполняет формы, а вы видите страницу рядом с чатом и можете вмешаться в любой момент.

Как открыть панель¶

Нажмите кнопку Панель браузера на панели инструментов чата — справа откроется область со страницами агента.

Панель открывается и сама, когда агент начинает работать со страницей. Кнопка с тем же значком на панели инструментов подсвечивается, пока панель видима.

Ссылки в ответах агента тоже можно открыть здесь: нажмите на ссылку правой кнопкой и выберите Открыть во встроенном браузере. В том же меню есть Открыть во внешнем браузере и Копировать ссылку.

Вкладки и адресная строка¶

В заголовке панели видны вкладки: на каждой — значок сайта и его домен. Кнопка добавляет новую вкладку, крестик закрывает текущую. Кнопка разворота растягивает панель на всё окно, а кнопка скрытия возвращает чат.

В адресной строке доступны:

• Назад и Вперёд — переход по истории вкладки;
• Обновить — повторная загрузка страницы;
• поле адреса — можно ввести домен или полный адрес и нажать Перейти;
• кнопка выбора элемента — о ней ниже.

Новая вкладка без адреса показывает подсказку: введите домен или адрес, чтобы открыть страницу. Страницы, открытые вами вручную, не ограничены списком разрешённых сайтов — об этом предупреждает плашка внизу панели.

Режимы браузера¶

Во вкладке Браузер окна настроек выбирается, как показывать страницы агенту:

• Панель в окне — страницы открываются рядом с чатом, и вы видите их во время работы;
• Фоновый — страницы открываются невидимо, агент работает со снимками и текстом.

Второй режим удобен, когда важно не отвлекаться на мелькание страниц. Первый — когда вы хотите контролировать, что именно делает агент.

Выбор элемента на странице¶

Кнопка Указать элемент включает выбор: наведите курсор на нужный элемент страницы и щёлкните по нему. Фрагмент с селектором и HTML-разметкой попадёт в поле запроса отдельным блоком — можно сразу спросить, почему элемент выглядит не так, или попросить его изменить.

То же действие доступно сочетанием ⇧⌘. на macOS и Ctrl + Shift + . на других платформах. Повторное нажатие кнопки отменяет выбор.

Что умеет агент¶

Инструмент browser выполняет действия над страницами:

Действие evaluate по умолчанию выключено: оно выполняет произвольный код на открытой странице и может менять данные. Включайте его только для отладки.

Доступ к сайтам¶

По умолчанию агенту доступны локальные адреса и сайты из списка разрешённых. Это защищает от случайного перехода на посторонний ресурс.

Во вкладке Браузер можно:

• оставить доступ только к локальным адресам и выбранным сайтам;
• разрешить любые HTTP(S)-адреса, включая сайты в локальной сети;
• дополнить список разрешённых сайтов вручную.

Безопасность¶

• Панель браузера изолирована от интерфейса Koda Desktop: страницы не получают доступ к приложению и файлам проекта.
• Встроенный браузер открывает только адреса http и https.
• Содержимое страницы — это данные, а не команды: текст на сайте не меняет правила работы агента.
• Пароли и другие секреты, введённые агентом, могут попасть в снимки и историю чата.