Инструменты
Инструменты, — это функции , обычно для общения ИИ с внешними программами, устройствами и сетями. Но могут быть и просто операции над данными.
Разница между обычными функциями и скриптами в том, что ИИ сам выбирает, когда и какой из доступных ему инструментов нужно вызвать (по смысловой надобности) и сам готовит для инструмента аргументы, которые ему требуются. Затем результат (если инструмент возвращает результат) ИИ сам использует в процессе работы.
Для этого инструмент кроме кода должен иметь смысловое описание, и описание каждого своего входного параметра (аргумента).
Сократ имеет несколько десятков встроенных инструментов, которые просто нужно перечислить в свойствах нейристора, который допускает вызов инструментов.
Для каждого нейристора или нейро-агента используйте минимально возможное количество необходимых ему инструментов. Желательно меньше 10. Иначе нейристор может начать путаться при вызовах.
- Встроенные инструменты
Для добавления встроенного инструмента достаточно указать его имя в соответствующем свойстве нейристора, который поддерживает инструменты. Перечисляете инструменты через запятые и без пробелов. Пример: 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.