Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.velesagent.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Инструменты, веб-поиск и MCP

Инструменты дают модели возможность действовать: читать файлы, искать в интернете, запускать команды, работать с памятью, создавать cron-задачи и подключаться к внешним MCP-серверам.

​
Общие ограничения

Для постоянной установки начните с ограничения рабочей области: 
{
  "tools": {
    "restrictToWorkspace": true
  }
}
Это ограничивает файловые действия и команды оболочки пределами рабочей области и снижает риск случайного доступа к чужим данным.

​
exec

exec запускает команды оболочки. Это мощный и рискованный инструмент. 
{
  "tools": {
    "exec": {
      "enable": true,
      "timeout": 60,
      "pathAppend": ""
    }
  }
}
ПолеНазначение
enableРегистрировать ли инструмент оболочки
timeoutТаймаут команды в секундах
pathAppendДополнительные директории для PATH
Если команды оболочки не нужны, выключите их: 
{
  "tools": {
    "exec": {
      "enable": false
    }
  }
}

​
Веб-поиск

Веб-поиск настраивается в tools.web.search. 
{
  "tools": {
    "web": {
      "search": {
        "provider": "brave",
        "apiKey": "BSA...",
        "maxResults": 5
      }
    }
  }
}
Поддерживаемые варианты:
ПровайдерЧто нужно
braveapiKey или BRAVE_API_KEY
tavilyapiKey или TAVILY_API_KEY
jinaapiKey или JINA_API_KEY
searxngbaseUrl или SEARXNG_BASE_URL
duckduckgoничего
Если учётные данные отсутствуют, Велес может перейти на DuckDuckGo. Прокси для веб-поиска и загрузки страниц: 
{
  "tools": {
    "web": {
      "proxy": "http://127.0.0.1:7890"
    }
  }
}

​
MCP

MCP подключает внешние серверы инструментов. 
{
  "tools": {
    "mcpServers": {
      "filesystem": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
      },
      "remote": {
        "url": "https://example.com/mcp/",
        "headers": {
          "Authorization": "Bearer ..."
        }
      }
    }
  }
}
Поддерживаются stdio и транспорт HTTP/SSE. Если type не указан, Велес определяет его по конфигурации.

​
Фильтрация инструментов MCP

Оставить только часть инструментов: 
{
  "tools": {
    "mcpServers": {
      "filesystem": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"],
        "enabledTools": ["read_file", "mcp_filesystem_write_file"]
      }
    }
  }
}
Правила:
  • ["*"] или отсутствие поля — зарегистрировать все инструменты;
  • [] — не регистрировать ни одного инструмента;
  • список имён — зарегистрировать только указанные;
  • принимаются исходные имена MCP и обёрнутые имена вида mcp_<server>_<tool>.
Для медленных MCP-вызовов: 
{
  "tools": {
    "mcpServers": {
      "slow": {
        "url": "https://example.com/mcp/",
        "toolTimeout": 120
      }
    }
  }
}

​
Разбор документов

documentParse использует Mistral OCR для извлечения текста из документов. 
{
  "tools": {
    "documentParse": {
      "mistralApiKey": "..."
    }
  }
}
Используйте зашифрованные секреты для ключа, если инструмент разбора документов нужен в постоянной установке.

​
Векторная память

Векторная память индексирует документы и помогает искать по смыслу. 
{
  "tools": {
    "vectorMemory": {
      "enabled": true,
      "embeddingModel": "openrouter/openai/text-embedding-3-small",
      "chunkTokens": 512,
      "chunkOverlap": 64,
      "syncIntervalSeconds": 60,
      "vectorWeight": 0.7,
      "textWeight": 0.3
    }
  }
}
Эта функция полезна для больших папок docs/, проектных материалов и длительных рабочих областей.

​
Глубокое исследование

Глубокое исследование настраивается в tools.deepResearch: отдельные модели для исследования, сжатия, планирования и итогового отчёта, лимиты токенов, число параллельных исследователей и бюджет поиска. Если не хотите тонко настраивать процесс, начните с отдельной страницы навыка: Глубокое исследование.

​
Минимальный безопасный профиль

{
  "tools": {
    "restrictToWorkspace": true,
    "exec": {
      "enable": false
    },
    "web": {
      "search": {
        "provider": "duckduckgo",
        "maxResults": 5
      }
    },
    "mcpServers": {}
  }
}
Этот профиль подходит для первых запусков, демонстраций и публичных каналов.