Dla agentów AI

Ta strona ma interfejs maszynowy: publiczne API z ofertą, serwer MCP i pliki odkrywania. Jeśli jesteś agentem AI - nie musisz parsować HTML-a. Jeśli jesteś człowiekiem - patrzysz właśnie na demo tego, co budujemy klientom.

Po co stronie interfejs dla agentów

Coraz częściej pierwszym odbiorcą strony firmowej nie jest człowiek, tylko asystent AI zbierający informacje dla klienta. Strona, która wystawia dane strukturalnie, trafia do odpowiedzi kompletna i bez przekłamań - a strona, która tego nie robi, jest streszczana z tego, co uda się wyciągnąć z układu wizualnego.

Co z tego mają nasi klienci

Dokładnie tę samą warstwę budujemy dla firm, które chcą, żeby ich katalog, cennik czy dostępność były czytelne dla asystentów AI - i żeby dało się przez nie złożyć zapytanie albo zamówienie.

Na czym to stoi

Na otwartych standardach, nie na własnym formacie: schema.org w JSON-LD, REST z opisem OpenAPI, Model Context Protocol oraz pliki llms.txt i agents.md. Nic tu nie wymaga naszego SDK.

REST - oferta w postaci danych

Wszystkie endpointy są publiczne, bez uwierzytelniania, pod adresem https://weles.biz/wp-json/weles/v1. Każda odpowiedź - również błędna - niesie nagłówek Link (RFC 8288) wskazujący dokumentację i pozostałe zasoby.

Metoda Ścieżka Opis Limit
GET / Mapa API: lista endpointów, limitów i plików odkrywania. -
GET /services Katalog obszarów wdrożeniowych z zakresem i czasem realizacji. -
GET /services/{slug} Szczegóły jednego obszaru. Nieznany slug zwraca 404 z listą dostępnych. -
GET /training Szkolenia i konsultacje wraz z programem. -
GET /cases Systemy zbudowane przez WELES (produkty własne, nie referencje). -
GET /faq Pytania i odpowiedzi w formie strukturalnej. -
GET /availability Czy przyjmujemy nowe projekty i jaki jest typowy czas startu. -
GET /contact Dane kontaktowe firmy. -
GET /search?q= Wyszukiwanie w ofercie, szkoleniach, opisach systemów i FAQ. 30/min
POST /inquiry Złożenie zapytania ofertowego. Wymaga pól contact i message. 5/min
POST /mcp Serwer MCP - JSON-RPC 2.0, bezstanowy. 60/min
GET /openapi.json Specyfikacja OpenAPI 3.1 całego API. -

Przykłady

# katalog obszarów wdrożeniowych
curl -s https://weles.biz/wp-json/weles/v1/services

# jeden obszar
curl -s https://weles.biz/wp-json/weles/v1/services/bi-i-dashboardy

# szukanie po frazie
curl -s 'https://weles.biz/wp-json/weles/v1/search?q=faktury'

# zapytanie ofertowe (tylko za zgodą klienta, w którego imieniu działasz)
curl -s -X POST https://weles.biz/wp-json/weles/v1/inquiry \
  -H 'Content-Type: application/json' \
  -d '{
        "contact": "anna@example.com",
        "company": "Przykład sp. z o.o.",
        "topic": "back-office",
        "message": "Miesięcznie księgujemy około 800 faktur kosztowych. Szukamy sposobu na automatyczny odczyt i wprowadzanie.",
        "agent_name": "asystent-klienta/1.0"
      }'

MCP - podłącz nas jako zestaw narzędzi

Pod adresem https://weles.biz/wp-json/weles/v1/mcp działa serwer Model Context Protocol w wariancie bezstanowym (JSON-RPC 2.0 po HTTP POST). Obsługuje initialize, ping, tools/list, tools/call, resources/list oraz resources/read.

Narzędzia

  • weles_list_services - Zwraca katalog obszarów wdrożeniowych WELES wraz z zakresem prac i orientacyjnym czasem wdrożenia.
  • weles_get_service - Zwraca szczegóły jednego obszaru wdrożeniowego po jego identyfikatorze (slug).
  • weles_search - Przeszukuje ofertę, szkolenia, opisy systemów i FAQ pod kątem podanej frazy.
  • weles_get_availability - Informuje, czy WELES przyjmuje nowe projekty i jaki jest typowy czas startu.
  • weles_submit_inquiry - Składa zapytanie ofertowe w imieniu klienta. Wymaga danych kontaktowych i opisu procesu. Używaj wyłącznie za wyraźną zgodą osoby, którą reprezentujesz.

Zasoby

  • weles://oferta - Wszystkie obszary wdrożeniowe, szkolenia i systemy własne w jednym dokumencie.
  • weles://faq - Najczęstsze pytania z odpowiedziami.
  • weles://kontakt - Dane kontaktowe oraz informacja o przyjmowaniu nowych projektów.

Wywołanie

# lista narzędzi
curl -s -X POST https://weles.biz/wp-json/weles/v1/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# wywołanie narzędzia
curl -s -X POST https://weles.biz/wp-json/weles/v1/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"weles_search","arguments":{"query":"zdjęcia produktowe"}}}'

Pliki odkrywania

Wszystkie generowane są z tego samego źródła co treść stron, więc nigdy nie prezentują nieaktualnej oferty. Nie leżą na dysku jako martwe pliki.

Zasady korzystania

Można

  • Cytować i streszczać treść oferty, także w odpowiedziach generowanych przez AI.
  • Odpytywać endpointy odczytowe bez ograniczeń ilościowych.
  • Podłączyć serwer MCP w dowolnym kliencie zgodnym ze standardem.

Nie należy

  • Składać zapytania ofertowego bez zgody osoby, w której imieniu działacie.
  • Zgadywać cen ani terminów - cennika nie publikujemy, a czasy podaje pole lead_time.
  • Przedstawiać sekcji „Systemy zbudowane przez WELES” jako referencji od klientów.

Zliczamy odwiedziny agentów w formie zagregowanej - bez adresów IP i bez danych identyfikujących. Nie blokujemy żadnego crawlera AI.

Chcecie taką warstwę u siebie?

Katalog, cennik albo dostępność czytelne dla asystentów AI - z możliwością złożenia zamówienia przez agenta.

Porozmawiajmy