OpenWebUI: System Prompt vs Skills vs MCP Tools — разбираем на живом примере валидации URL

• System Prompt — инструкция для LLM
  
• Skills — пост-процессоры ответа
  
• MCP Tools — исполняемый код для действий «в реальном мире»

ИИ-ассистент техподдержки HOSTKEY. Задача: помогать по серверам,
панели Invapi и документации hostkey.ru.


### 🌐 ЯЗЫК (приоритет №1)
- Отвечай ТОЛЬКО на русском, независимо от языка вопроса.
### 🔗 ССЫЛКИ — АЛГОРИТМ (строго)
Файл в базе: `<раздел>@<тема>@ru.md`
Преобразование:
1. Убрать `@ru.md` → `faq@network_settings`
2. Разбить по `@` → `["faq","network_settings"]`
3. Собрать URL: `https://hostkey.ru/documentation/faq/network_settings/`

• Задаёт роль, тон и тематику ответов;
  
• Обучает модель правильно формировать ссылки по бизнес-алгоритму;
  
• Запрещает нежелательные действия (код, выдуманные URL);

• Не проверяет, существует ли ссылка на самом деле;
  
• Не делает сетевые запросы;
  
• Не знает о существовании инструмента url_fetch_mcp — для модели это «магия».

• Парсить и анализировать текст ответа
  
• Вызывать внешние инструменты (MCP Tools)
  
• Модифицировать вывод перед отправкой пользователю

---
name: url-validator-with-mcp
description: Validates URLs via url_fetch_mcp, removes invalid ones,
             and ensures proper formatting for valid links.
version: "2.0"
tags: [validation, urls, links, mcp, formatting, self-check]
requires_tools: ["url_fetch_mcp"]
---
# 🔗 URL Validator Skill (MCP-backed + Format Enforcement)
## 🎯 Purpose
After generating a response containing URLs:
1. **Validate accessibility** using `url_fetch_mcp`
2. **Remove entirely** invalid/unreachable links (text + URL)
3. **Enforce proper formatting** for valid links
4. Output ONLY the cleaned, validated response — no logs, no commentary

• Он находит URL в сгенерированном ответе (выполняет его парсинг);
  
• Вызывает MCP Tools url_fetch_mcp передавая его последовательно найденные URL;
  
• Применяет бизнес-правила: удалять битые ссылки, форматировать рабочие;
  
• Возвращает «чистый» ответ без мета комментариев.

• Не учит модель, какстроить ссылки (это задача системного промта);
  
• Не заменяет логику бизнес-правил;
  
• Не работает автономно и требует подключённого MCP Tool, так как сам он не может пройти по ссылке и проверить ответ от сервера.

from __future__ import annotations
import logging, re, sys, time
from dataclasses import asdict, dataclass
from typing import Optional
from urllib.parse import urlparse
import requests
logging.basicConfig(
    stream=sys.stderr,
    level=logging.INFO,
    format='%(asctime)s [URL_FETCH] %(levelname)s: %(message)s'
)
logger = logging.getLogger(__name__)
DEFAULT_TIMEOUT = 5.0
USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64)..."
@dataclass
class URLCheckResult:
    valid: bool
    url: str
    normalized_url: Optional[str] = None
    status_code: Optional[int] = None
    response_time_ms: Optional[float] = None
    error: Optional[str] = None
    content_type: Optional[str] = None
    final_url: Optional[str] = None
    ssl_valid: Optional[bool] = None
    def to_dict(self) -> dict:
        return {k: v for k, v in asdict(self).items() if v is not None}
def check_url(
    url: str,
    timeout: float = DEFAULT_TIMEOUT,
    follow_redirects: bool = True,
    check_ssl: bool = True
) -> dict:
    """MCP Tool: Проверка доступности URL"""
    logger.info(f"MCP call: check_url(url='{url}')")
    # 1. Валидация формата
    is_valid, err = _validate_url_format(url)
    if not is_valid:
        return URLCheckResult(valid=False, url=url, error=err).to_dict()
    # 2. HTTP-запрос с обработкой ошибок
    try:
        response = requests.head(url, timeout=timeout,
                                allow_redirects=follow_redirects,
                                verify=check_ssl)
        # ... анализ ответа ...
        return URLCheckResult(valid=True, status_code=response.status_code,
                             response_time_ms=...).to_dict()
    except requests.exceptions.Timeout:
        return URLCheckResult(valid=False, error="Таймаут").to_dict()
    except requests.exceptions.SSLError:
        return URLCheckResult(valid=False, error="SSL-ошибка").to_dict()
    # ... другие исключения ...

• Реально «стучится» по ссылке (сетевой запрос);
  
• Возвращает структурированный результат: status_code,response_time_ms,error;
  
• Обрабатывает исключения: таймауты, SSL-ошибки, редиректы;

• LLM получает вопрос + системный промт;
  
• Находит в базе документ: controlpanel@network_interface@ru.md;
  
• Применяет алгоритм: 
  "убрать @ru.md" → ["controlpanel","network_interface"] > "https://hostkey.ru/documentation/controlpanel/network_interface/" ;
  
• Генерирует черновик:

• Skill получает черновик;
  
• Парсит текст, находит 1 ссылку;
  
• Вызывает MCP Tool: 

• Получает результат:

• Проверяет формат: Markdown - Да, HTTPS - Да, текст ≠ вопрос - Да ;
  
• Возвращает ответ без изменений (всё валидно).

• MCP Tool вернул:

• Skill удаляет конструкцию "[текст](ссылка)" из ответа;
  
• Выдает ответ без ссылки:

• System Prompt —  отвечает за поведение ассистента, правила, бизнес-логику, «Знай, как надо»;
  
• Skill — на нем пост-обработка и координация, «Проверь, что сделано»;
  
• MCP Tool — выполняет конкретные действия «в мире», «Сделай и доложи».

• Официальная документация OpenWebUI Skills
  
• Model Context Protocol Specification
  
• Документация по MCP и mcpo в OpenWebUI