Инструменты

Инструменты, — это функции , обычно для общения ИИ с внешними программами, устройствами и сетями. Но могут быть и просто операции над данными.

Разница между обычными функциями и скриптами в том, что ИИ сам выбирает, когда и какой из доступных ему инструментов нужно вызвать (по смысловой надобности) и сам готовит для инструмента аргументы, которые ему требуются. Затем результат (если инструмент возвращает результат) ИИ сам использует в процессе работы.

Для этого инструмент кроме кода должен иметь смысловое описание, и описание каждого своего входного параметра (аргумента).

Сократ имеет несколько десятков встроенных инструментов, которые просто нужно перечислить в свойствах нейристора, который допускает вызов инструментов.

Для каждого нейристора или нейро-агента используйте минимально возможное количество необходимых ему инструментов. Желательно меньше 10. Иначе нейристор может начать путаться при вызовах.

 

  1. Встроенные инструменты

Для добавления встроенного инструмента достаточно указать его имя в соответствующем свойстве нейристора, который поддерживает инструменты. Перечисляете инструменты через запятые и без пробелов. Пример: pdfsearch,pdfextract,pdfmerge

Встроенные инструменты:

pdfsearch — поиск текста и данных в PDF-документах

pdfextract — извлечение текста, изображений или содержимого из PDF

pdfmerge — объединение нескольких PDF-документов

pdfmetadata — получение или изменение метаданных PDF-документа

pdfpages — получение информации о страницах PDF-документа

pdftoimage — преобразование страниц PDF в изображения

pdfsplit — разделение PDF-документа на отдельные части

pdfunlock — снятие ограничений или пароля с PDF-документа

networkconnectivity — проверка доступности сетевого подключения

networkdns — выполнение DNS-запросов и разрешение доменных имён

networkinterfaces — получение информации о сетевых интерфейсах

networkping — проверка доступности узла по сети

networkportcheck — проверка доступности определённого сетевого порта

networkportscan — сканирование диапазона сетевых портов

 

  • Описание собственного инструмента

Вы можете добавить собственный инструмент (ы) описав их функцию в скрипте, или вызвав из скрипта метод внешнего плагина.

UserTool(

имя | – слитное краткое имя-описание функции, желательно на англ.

InputSchema | – JSON схема и описание параметров

Description – описание функции инструмента для ИИ

){

Ваш скрипт – все что должен сделать инструмент

return result; – что он должен вернуть для ИИ

}

Как описывать JSON – схему параметров, пример:

{

“type”: “object”,

“description”: “Save an important finding or note during research.”,

“properties”: {

“category”: {

“type”: “string”,

“description”: “Category for the note (e.g., benefit, challenge, statistic, quote).”

},

“content”: {

“type”: “string”,

“description”: “The content of the note to save.”

},

“source”: {

“type”: “string”,

“description”: “Source or reference for this information.”

}},

“required”: [

“content”]}

1.2 Диалог с расширением \ инструментом

Вы можете создавать удобные расширения редактора и других функций, не только используя выбор элементов графа мышкой, но и с элементами диалога (кнопки, текстовый ввод, выбор файла).

Для этого изучите раздел описания про диалоговые операторы DSL.