# Local tool-agent

Режим `--tools` предназначен для локальных моделей Ollama. Маленькая модель не выполняет действия напрямую, а предлагает JSON-план. CLI проверяет план и выполняет только разрешенные встроенные tools.

Пример:

```bash
iola ask "выгрузи школы на Петрова в csv" --profile local --tools
iola ask "найди детсады без телефона" --profile local --tools --reasoning verify
```

Минимальные встроенные tools:

- `search_data` - поиск по локальной SQLite-БД и открытым данным.
- `get_card` - карточка объекта.
- `export_report` - отчет или выгрузка результата в CSV/JSON.
- `file_read` - чтение локального файла в разрешенном workspace.
- `browser_open` - открыть страницу через browser runtime и вернуть текст.

Старые имена `search_local`, `run_report`, `export_data` сохранены как алиасы для совместимости, но новый планировщик их не предлагает.

MCP tools:

Локальная модель может вызывать подключенные MCP tools через CLI-мост. Встроенный локальный MCP-сервер доступен как `iola-local`, а tool указывается в виде:

```text
mcp:iola-local:search
mcp:iola-local:card
mcp:iola-local:report
mcp:iola-local:browser.text
```

Дополнительные stdio MCP-серверы можно добавить в `~/.iola/config.json`:

```json
{
  "mcp": {
    "servers": {
      "example": {
        "command": "npx",
        "args": ["-y", "some-mcp-server"]
      }
    }
  }
}
```

После этого локальный plan может вызвать tool как `mcp:example:tool_name`.

Toolsets:

```bash
iola tools toolsets
iola tools profile safe
iola tools profile full
```

Для слабых локальных моделей подключен skill `local-model`: CLI просит модель не выполнять действия напрямую, а предложить JSON-план. План проверяется по разрешенным tools и только после этого выполняется.

Управление разрешениями:

```bash
iola permissions list
iola permissions deny export_report
iola permissions allow export_report
```

Режимы планирования:

```bash
--reasoning fast
--reasoning verify
--reasoning vote
```

Если Ollama недоступна или модель вернула некорректный JSON, CLI использует fallback-планировщик для типовых запросов.
