Czego szukasz?

Wpisz temat, narzędzie lub problem do rozwiązania.

← Wszystkie artykuły

Jak AI może pracować z WordPressem przez API

Czerwony ołówek między kartką tekstu a pustym obrysem okna przeglądarki

AI może przygotować tytuł, konspekt i roboczą treść, a WordPress REST API zapisać je jako szkic. Najbardziej przewidywalny układ oddziela generowanie od publikacji. Model proponuje tekst, aplikacja kontroluje dane i uprawnienia, a człowiek zatwierdza materiał przed udostępnieniem.

Nie musisz przekazywać modelowi hasła administratora ani dostępu do całego serwera. Wystarczy wąska integracja wykonująca konkretną operację. Poniżej przejdziemy przez zapis szkicu, obsługę mediów i najczęstszy problem automatyzacji: ponowienie po niejednoznacznej odpowiedzi.

Podziel proces na cztery kroki

Praktyczny proces redakcyjny może wyglądać tak:

  1. Użytkownik zatwierdza temat i materiały wejściowe.
  2. Model przygotowuje propozycję tekstu w ustalonym formacie.
  3. Aplikacja waliduje propozycję i zapisuje szkic.
  4. Redaktor sprawdza źródła, wygląd i termin publikacji.

Kluczowe jest miejsce, w którym podejmowana jest decyzja o statusie. Pole status powinno pochodzić z zaufanej logiki aplikacji. Nie kopiuj całego obiektu modelu bezpośrednio do żądania WordPressa.

Ogólny mechanizm wymiany danych opisuje wprowadzenie do REST API. Jeśli proces ma korzystać z dodatkowych funkcji AI, pomocny będzie też tekst o ograniczaniu narzędzi agenta.

Konto integracji i hasło aplikacji

WordPress obsługuje hasła aplikacji używane do uwierzytelniania REST API przez HTTPS. Utwórz osobne hasło dla konkretnej integracji, żeby można było je odwołać bez zmiany głównego hasła użytkownika.

Hasło aplikacji nie nadaje osobnego zestawu uprawnień dla jednego endpointu. Działa w zakresie uprawnień przypisanego konta. Dlatego ważne jest konto o możliwie wąskiej roli, a nie samo wydzielenie hasła.

Przykładowo konto przygotowujące tylko szkice nie powinno mieć prawa do samodzielnej publikacji ani edycji cudzych materiałów. Domyślna rola współpracownika ma ograniczenia, w tym dotyczące mediów. Jeśli integracja ma przesyłać pliki, zaprojektuj potrzebne uprawnienia osobno, zamiast od razu nadawać administratora.

Sekret przechowuj po stronie aplikacji. Nie umieszczaj go w promptach, kodzie przeglądarki, repozytorium ani logach. Ograniczenie dotyczy także pełnego nagłówka Authorization.

Zamiana odpowiedzi modelu na szkic

Załóżmy, że model może zwrócić wyłącznie dwa pola: title i text. Ten mały przykład przyjmuje zwykły tekst, dzieli go na akapity i wymusza status szkicu:

from html import escape

def draft_payload(candidate):
    if not isinstance(candidate, dict) or set(candidate) != {'title', 'text'}:
        raise ValueError('Only title and text are accepted')
    title, text = candidate['title'], candidate['text']
    if not isinstance(title, str) or not isinstance(text, str):
        raise ValueError('Expected strings')
    title, text = title.strip(), text.strip()
    if not 1 <= len(title) <= 150 or not 1 <= len(text) <= 20000:
        raise ValueError('Unexpected content length')
    paragraphs = [part.strip() for part in text.split('\n\n') if part.strip()]
    return {'title': title, 'status': 'draft',
            'content': '\n'.join('<p>' + escape(part) + '</p>' for part in paragraphs)}

Zapisz funkcję w draft.py. Odrzuca dodatkowe klucze, puste wartości i zbyt duże wejście. Treść jest escapowana przed umieszczeniem w HTML, więc wygenerowany tag nie staje się automatycznie aktywnym kodem.

To celowo ograniczony format. Nie obsługuje gotowych bloków Gutenberga, obrazów ani dowolnego HTML. Jeżeli potrzebujesz bogatszej treści, wprowadź jawny schemat bloków i dozwolone elementy zamiast usuwania walidacji.

Przykładowe użycie:

from draft import draft_payload

payload = draft_payload({
    'title': 'Roboczy poradnik',
    'text': 'Pierwszy akapit.\n\nDrugi akapit.'
})

Test lokalny obejmuje wymuszenie draft, odrzucenie próby przekazania status=publish i zamianę znaczników HTML na tekst. Nie jest to test publikacji na rzeczywistej witrynie.

Żądanie utworzenia wpisu

Utworzenie szkicu odbywa się przez POST /wp-json/wp/v2/posts. Przykładowe ciało żądania wygląda tak:

{
  "title": "Roboczy poradnik",
  "content": "<p>Pierwszy akapit.</p>",
  "status": "draft"
}

Aplikacja wysyła je do wcześniej ustalonego adresu witryny z odpowiednim uwierzytelnieniem. Nie pozwalaj modelowi wybierać dowolnego hosta docelowego ani przekazywać własnego nagłówka autoryzacji.

Po sukcesie zapisz ID zwróconego wpisu. Kolejne poprawki kieruj do tego zasobu, zamiast tworzyć nowy za każdym razem. Sprawdź w odpowiedzi rzeczywisty status i pola zapisane przez WordPress.

Do diagnostyki HTTP przyda się cURL. Żądania zapisujące dane testuj na środowisku roboczym i nie kopiuj do terminala sekretu widocznego później w historii.

Timeout nie oznacza, że szkic nie powstał

Serwer może utworzyć wpis, a odpowiedź nie dotrzeć do klienta. Bezwarunkowe ponowienie POST grozi wtedy duplikatem.

Przypisz zleceniu własny identyfikator i przechowuj mapowanie na ID WordPressa w aplikacji. Zapisuj stan wysyłki oraz odpowiedź. Po niejednoznacznym błędzie najpierw uzgodnij wynik, a dopiero potem podejmij decyzję o powtórzeniu.

Sam slug nie gwarantuje idempotencji. WordPress może utworzyć kolejny adres z przyrostkiem. Jeśli potrzebujesz mocnej gwarancji, zaprojektuj kontrolowany endpoint lub mechanizm po stronie serwera, który atomowo rozpoznaje identyfikator zlecenia.

Problem ten jest szerszy niż WordPress. Omawia go artykuł o bezpiecznym ponawianiu operacji.

Obrazy wymagają osobnego przygotowania

Media mają własny endpoint. Po przesłaniu pliku otrzymujesz ID załącznika, które możesz przypisać jako featured_media wpisu. Uzupełnij tytuł, tekst alternatywny, podpis i opis.

Alt powinien opisywać funkcję lub zawartość obrazu, a nie być listą fraz SEO. Podpis widoczny pod ilustracją powinien odpowiadać temu, co rzeczywiście pokazuje. Grafika koncepcyjna nie może udawać wyniku testu.

Przed importem sprawdź rozmiar, format i prawa do użycia. Zachowaj oryginał w materiałach wpisu. Automatyzacja nie powinna nadpisywać jedynej kopii pliku ani dodawać kilku dekoracyjnych obrazów tylko dlatego, że potrafi je wygenerować.

SEO i data publikacji są częścią przeglądu

Podstawowe REST API nie gwarantuje zapisu wszystkich pól konkretnej wtyczki SEO. Zależy to od jej integracji oraz rejestracji metadanych. Nie zakładaj, że dowolny klucz przesłany w meta zostanie przyjęty.

Po zapisie sprawdź tytuł, opis, kategorię, autora i rzeczywisty HTML. Analiza redakcyjna wtyczki może wymagać działania edytora; samo uzupełnienie frazy nie dowodzi wykonania oceny.

Przy zaplanowanej publikacji uwzględnij strefę witryny i zgodność daty lokalnej z UTC. Zachowaj termin w materiałach roboczych, a po zmianie zaktualizuj także datę widoczną w tekście.

Do zadań administracyjnych wykonywanych przez SSH może być wygodniejsze WP-CLI. Wybór interfejsu powinien wynikać z miejsca uruchamiania procesu i wymaganych uprawnień.

Co sprawdzić przed dopuszczeniem automatyzacji

Przygotuj próbę błędnego formatu, nadmiernej długości, nieuprawnionej publikacji i powtórzonego zlecenia. Sprawdź również odwołanie hasła aplikacji oraz czy logi nie zawierają sekretu.

Treść źródłowa i odpowiedź modelu nie mogą zmieniać zasad wykonania. Odnośnik lub cytowany dokument może zawierać próbę prompt injection. Aplikacja nadal ma tworzyć wyłącznie dozwolony szkic.

Najczęstsze pytania

Czy AI potrzebuje konta administratora?

Nie. Integracja powinna dostać tylko uprawnienia potrzebne do określonych operacji.

Czy hasło aplikacji ogranicza się do jednego endpointu?

Nie samo z siebie. Zakres dostępu wynika z uprawnień użytkownika i dodatkowych ograniczeń integracji.

Czy można ponowić POST po każdym timeoutcie?

Nie bez sprawdzenia wyniku. Wpis mógł już powstać, mimo że klient nie odebrał odpowiedzi.

Czy przykład automatycznie publikuje tekst?

Nie. Walidator wymusza szkic, a publikacja pozostaje osobnym etapem przeglądu.

Źródła

Data publikacji: 16.11.2026.

KP
O AUTORZE

Krystian Proć

Tworzę narzędzia do pracy z danymi, systemy backendowe i automatyzacje. Pracuję z SQL, PHP, TypeScriptem i Dockerem; rozwijam m.in. dragon-island.com. AI pomaga mi przyspieszać pracę, a architekturę, weryfikację i decyzje techniczne biorę na siebie. Na Trybie Technicznym dzielę się doświadczeniami z budowania i utrzymywania własnych projektów.

Dyskusja

Dodaj komentarz

Twój adres email nie zostanie opublikowany. Wymagane pola są oznaczone *