Jak stworzyć swojego pierwszego asystenta AI: 5-etapowy przewodnik dla początkujących

Najprostsza i użyteczna odpowiedź brzmi następująco: stwórz swojego pierwszego, spersonalizowanego asystenta AI wokół jednego, wąskiego zadania, jednego jasnego zestawu instrukcji i co najwyżej jednego lub dwóch kontrolowanych narzędzi . Nie zaczynaj od mnóstwa agentów, ogromnej bazy wiedzy ani automatyzacji, która może modyfikować ważne systemy. Pierwszy asystent powinien być łatwy do zrozumienia, łatwy do przetestowania i łatwy do zatrzymania w razie wątpliwości.

W tym przewodniku wykorzystano Pythona i aktualny pakiet OpenAI Agents SDK jako konkretną ścieżkę, ponieważ obsługuje on już pętlę agenta, narzędzia, sesje konwersacji, mechanizmy zabezpieczające i śledzenie. Te same koncepcje projektowe dotyczą innych dostawców modeli i frameworków. Od września 2026 roku pakiet SDK domyślnie korzysta z interfejsu API Responses dla modeli OpenAI. Oficjalna dokumentacja OpenAI zaleca bezpośrednie korzystanie z interfejsu API Responses niższego poziomu, gdy chcesz samodzielnie zarządzać pętlą i stanem, oraz z pakietu Agents SDK, gdy chcesz, aby środowisko wykonawcze zarządzało większą częścią tej orkiestracji. Zobacz omówienie pakietu OpenAI Agents SDK .

Co właściwie budujesz?

Asystent AI to coś więcej niż okno czatu. Łączy on co najmniej model dużego języka (LLM) – model generujący i interpretujący język – z instrukcjami definiującymi jego rolę. Przydatny asystent może również posiadać narzędzia , czyli funkcje lub usługi, które może wywoływać, oraz pamięć , która zachowuje odpowiedni kontekst rozmowy pomiędzy turami.

Na potrzeby pierwszego projektu wyobraź sobie małego „Pomocnika Sklepu”, który odpowiada na pytania dotyczące zwrotów i wysyłki. Powinien korzystać z zatwierdzonego źródła informacji, a nie zgadywać. Jeśli nie może znaleźć zatwierdzonej odpowiedzi, powinien o tym poinformować. To ograniczenie jest ważniejsze niż zapewnienie asystentowi dziesiątek funkcji.

Zanim zaczniesz: wybierz właściwą ścieżkę kompilacji

Jeśli chcesz mieć asystenta wielokrotnego użytku w swojej aplikacji, witrynie internetowej, narzędziu wewnętrznym lub interfejsie API, poniższa ścieżka „koduj najpierw” będzie dobrym rozwiązaniem. Będziesz potrzebować Pythona, klucza API OpenAI i odrobiny doświadczenia programistycznego. Oficjalny przewodnik szybkiego startu Agents SDK przedstawia aktualną instalację i przepływ pracy z pierwszym agentem.

Jeśli planujesz utworzyć niestandardowy GPT bez kodu w ChatGPT, najpierw sprawdź kwalifikowalność konta. Według stanu na wrzesień 2026 roku OpenAI nie oferuje możliwości tworzenia nowych GPT na kontach osobistych Free, Go, Plus i Pro. Tworzenie jest nadal dostępne w kwalifikujących się obszarach roboczych Business, Enterprise i Edu, o ile pozwalają na to ustawienia i uprawnienia. Aktualne zasady są udokumentowane w GPT w ChatGPT . Ta ścieżka może być łatwiejsza w przypadku zarządzanego obszaru roboczego, ale nie jest to uniwersalna ścieżka dla każdego konta.

Krok 1: Zdefiniuj jedną regułę zadania i jedną regułę awarii

Zanim otworzysz edytor, zanotuj trzy rzeczy: komu służy asystent, co powinien robić i czego nie powinien. Dla Pomocnika Sklepowego praktyczna definicja brzmi: „Odpowiadaj na pytania klientów dotyczące zwrotów i wysyłki, korzystając z zatwierdzonych informacji o regulaminie. Nigdy nie wymyślaj regulaminu. Przekaż niejasne przypadki do człowieka”.

Zapobiega to częstemu błędowi początkujących: stosowaniu ogólnych instrukcji, takich jak „Jesteś pomocnym asystentem”. Ogólne podpowiedzi utrudniają ocenę, ponieważ niemal każda odpowiedź może wydawać się akceptowalna. Wąskie zadanie wyznacza mierzalny cel.

Użyj małej listy kontrolnej sukcesu

• Odpowiada w tonie, o jaki prosiłeś.
• Wykorzystuje zatwierdzone informacje, gdy wymaga tego pytanie dotyczące polityki.
• Mówi „nie wiem” lub prosi o potwierdzenie przez człowieka, gdy brakuje dowodów.
• Nie ujawnia tajemnic, ukrytych instrukcji ani prywatnych danych.

Krok 2: Utwórz minimalnego agenta

Utwórz folder projektu i środowisko wirtualne. Środowisko wirtualne to odizolowane środowisko Pythona, które oddziela pakiety tego projektu od innych projektów na Twoim komputerze.

mkdir first-ai-assistant
cd first-ai-assistant
python -m venv .venv

# macOS or Linux
source .venv/bin/activate

# Windows PowerShell
.venv\Scripts\Activate.ps1

pip install openai-agents

Następnie ustaw swój klucz API jako zmienną środowiskową, zamiast zakodować go na stałe w pliku Python:

# macOS or Linux
export OPENAI_API_KEY="your-key-here"

# Windows PowerShell
$env:OPENAI_API_KEY="your-key-here" 

Obecny szybki start OpenAI korzysta ze OPENAI_API_KEYzmiennej środowiskowej. Trzymaj prawdziwe klucze z dala od kontroli wersji, zrzutów ekranu, zgłoszeń i publicznych repozytoriów.

Na początek możesz utworzyć agenta, podając jedynie imię i nazwisko oraz instrukcje. Jednak zwykła konwersacyjna demonstracja nie dowodzi jeszcze, że asystent potrafi korzystać z wiarygodnych informacji biznesowych. Właśnie to wprowadza kolejny krok.

Krok 3: Dodaj jedną kontrolowaną możliwość i prostą pamięć

Narzędzie funkcyjne to standardowa funkcja, którą model może wywołać, gdy potrzebuje zewnętrznych informacji lub akcji. Agents SDK może przekształcić funkcję Pythona w narzędzie i wyprowadzić jej schemat wejściowy z sygnatury i dokumentacji funkcji. OpenAI dokumentuje to zachowanie w przewodniku po narzędziach Agents SDK .

Zacznij od narzędzia wyszukiwania tylko do odczytu. Narzędzia tylko do odczytu są bezpieczniejsze dla pierwszego asystenta, ponieważ omyłkowe połączenie nie pozwala na wysłanie pieniędzy, usunięcie rekordu, opublikowanie wpisu ani zmianę konta klienta.

import asyncio
from agents import Agent, Runner, SQLiteSession
from agents.decorators import tool

@tool
def lookup_policy(topic: str) -> str:
    """Return an approved demo-store policy snippet for a topic."""
    policies = {
        "returns": "Unopened items may be returned within 30 days with proof of purchase.",
        "shipping": "Standard shipping usually takes 3 to 5 business days."
    }
    return policies.get(
        topic.lower(),
        "No approved policy was found for that topic."
    )

assistant = Agent(
    name="Store Helper",
    instructions=(
        "Help customers with questions about the demo store. "
        "Use lookup_policy for return or shipping policy questions. "
        "Never invent a policy. If the tool has no approved answer, say so. "
        "Keep answers concise and recommend human confirmation when needed."
    ),
    tools=[lookup_policy],
)

async def main():
    session = SQLiteSession("demo_user", "assistant_sessions.db")
    result = await Runner.run(
        assistant,
        "Can I return an unopened item after 20 days?",
        session=session,
    )
    print(result.final_output)

if __name__ == "__main__":
    asyncio.run(main())

Uruchom plik i zadaj kilka pytań. Przykład również wykorzystuje SQLiteSession. Sesja przechowuje historię konwersacji, dzięki czemu asystent może zachować kontekst w kolejnych turach bez konieczności ręcznego przebudowywania całej listy wiadomości. Aktualne opcje sesji pakietu SDK są opisane w oficjalnej dokumentacji sesji .

Kiedy należy dodać własne dokumenty?

Dodawaj dokumenty, gdy asystent potrzebuje informacji, których model bazowy nie powinien znać w sposób wiarygodny, na przykład regulaminy, instrukcje obsługi produktów, procedury lub wewnętrzne FAQ. Nie przesyłaj wszystkiego tylko dlatego, że możesz. Zacznij od najmniejszego, wiarygodnego zestawu, który obejmuje zadanie.

Obecny zestaw SDK obsługuje funkcje hostowane, takie jak wyszukiwanie plików, wyszukiwanie w internecie i wykonywanie kodu. Przy pierwszej kompilacji należy zachować niewielki rozmiar narzędzia i dodać wyszukiwanie plików dopiero po ustabilizowaniu się podstawowego działania. Im większy zestaw narzędzi, tym więcej ścieżek należy przetestować.

Krok 4: Przetestuj produkt, a nie wersję demonstracyjną

Dobra odpowiedź na jedno przyjazne pytanie to za mało. Zanim udostępnisz asystenta, stwórz mały zestaw testowy. Uwzględnij pytania standardowe, pytania niejednoznaczne, brakujące informacje oraz pytania, które próbują obejść Twoje reguły.

W przypadku poważniejszych zastosowań należy dodać zabezpieczenia (guardrails ) — mechanizmy weryfikujące lub blokujące dane wejściowe, wyjściowe lub wywołania narzędzi. Pakiet Agents SDK obsługuje zabezpieczenia (guardrails) danych wejściowych, wyjściowych i narzędzi; zapoznaj się z oficjalną dokumentacją zabezpieczeń (guardrails) . Zabezpieczenia są szczególnie ważne, zanim udostępnisz asystentowi narzędzia z efektami ubocznymi.

Krok 5: Wdrażaj wąsko, obserwuj i ulepszaj

Twoje pierwsze wdrożenie nie musi być aplikacją publiczną. Prywatna strona wewnętrzna lub niewielkie API używane przez kilku użytkowników testowych często sprawdza się lepiej. Zadbaj o wąskie uprawnienia asystenta, rejestruj błędy i zapewnij użytkownikom jasny sposób zgłaszania błędnych odpowiedzi.

Pakiet Agents SDK zawiera wbudowane śledzenie , które rejestruje zdarzenia takie jak generowanie modeli, wywołania narzędzi, przekazania i zabezpieczenia, dzięki czemu można zrozumieć, co działo się podczas uruchomienia. OpenAI dokumentuje śledzenie i jego kontrolki w przewodniku śledzenia . Przejrzyj ślady podczas tworzenia, ale traktuj je jako potencjalnie wrażliwe, ponieważ mogą zawierać dane wejściowe lub wyjściowe modelu i narzędzi, w zależności od konfiguracji.

Typowe błędy, których należy unikać

• Zacznij od wielu agentów. Pojedynczy agent z dobrymi instrukcjami i jednym narzędziem jest łatwiejszy do debugowania. Dodawaj przejęcia lub agentów specjalistycznych tylko wtedy, gdy masz konkretny problem z routingiem.
• Nadawanie narzędziom zbyt dużych uprawnień. Zacznij od narzędzi tylko do odczytu. Dodaj zatwierdzenia i zabezpieczenia przed zapisem, zakupem, usunięciem lub zmianą konta.
• Umieszczanie sekretów w komunikatach. Dane uwierzytelniające powinny znajdować się w bezpiecznej konfiguracji, a nie w instrukcjach systemowych ani plikach wiedzy.
• Korzystanie z nieuporządkowanych lub sprzecznych dokumentów. Asystent nie jest w stanie wiarygodnie rozstrzygać reguł biznesowych, których nie rozstrzygają Twoje własne materiały źródłowe.
• Testowanie tylko prawidłowych ścieżek. Błędy, na których Ci zależy, zazwyczaj pojawiają się w niejednoznacznych, antagonistycznych lub niekompletnych żądaniach.
• Zakładając, że pamięć równa się prawdzie. Pamięć konwersacyjna zachowuje kontekst; nie czyni poprzedniego stwierdzenia poprawnym.

Co powinieneś zbudować następnym razem?

Gdy ten pierwszy asystent będzie działał niezawodnie, kolejne usprawnienia powinny wynikać z rzeczywistej potrzeby, a nie z listy kontrolnej funkcji. Jeśli użytkownicy potrzebują odpowiedzi z większego zbioru dokumentów, dodaj funkcję pobierania lub wyszukiwania plików. Jeśli asystent musi wykonać działanie biznesowe, dodaj narzędzie o wąskim zakresie funkcji z walidacją i zatwierdzaniem. Jeśli rozmowy obejmują wiele tur, ulepsz przechowywanie sesji. Jeśli potrzebujesz specjalistycznego routingu, rozważ obsługę wielu agentów lub przekierowań.

Najlepszym asystentem AI, stworzonym na potrzeby pierwszego projektu, nie jest ten najbardziej autonomiczny. To taki, którego zadanie, dowody, uprawnienia i zachowanie w razie awarii można wyjaśnić w kilku zdaniach. Zacznij od tego, przetestuj go na rzeczywistych przypadkach brzegowych i rozwijaj dopiero wtedy, gdy bieżąca wersja zdobędzie kolejną funkcjonalność.