Od prototypu po asystenta skierowanego do gości

Uruchomienie wymaga czegoś więcej niż wersji demonstracyjnej. Zakończ widgetem, budżetem, limitami dostępu i procesem konserwacji.

Kroki te odnoszą się do funkcji zidentyfikowanych w kodzie aplikacji. Ten materiał nie został sprawdzony na żywo; sprawdź dokumentację i opcje w swojej wersji.

Jak to działa, krok po kroku

Przed użyciem sprawdź dostęp

Uprawnienia muszą być egzekwowane przez serwery i warstwę danych. Nie pozwól, aby model decydował o tym, czy użytkownik może zobaczyć dokument. Filtruj źródła zanim wejdą w kontekst, a nie po wygenerowaniu odpowiedzi. Używaj poświadczeń o minimalnym dostępie, trzymaj je z dala od monitów, zrzutów ekranu i kodu przeglądarki oraz obracaj odsłonięte klucze. Lista dozwolonych domen widżetów nie zastępuje uwierzytelniania API. Uwierzytelnienie identyfikuje Cię; autoryzacja określa operacje i dane, których możesz użyć. Test również odmówił dostępu.

Błędy wymagają wyraźnych ścieżek

Limit czasu różni się od błędu uprawnień. Ponawiaj tylko błędy przejściowe, z ograniczonymi próbami i rosnącymi opóźnieniami. Operacja powodująca skutki uboczne może zostać wykonana przed utratą odpowiedzi; ponowna próba bez klucza idempotencji może zduplikować efekt. Przesyłanie strumieniowe pokazuje postęp, ale nie gwarantuje ukończenia. Punkty kontrolne mogą pozwolić na wznowienie nieudanych etapów w ramach limitów czasu wykonania. Przechowuj identyfikator przebiegu, etap, czas trwania i błąd podczas usuwania wpisów tajnych z dzienników. Mierz wolne ścieżki i średnie.

Koszt dotyczy całej ścieżki

Zliczaj wywołania modeli, tokeny wejściowe i wyjściowe, osadzanie, reranking, wizję i narzędzia. Rozumowanie może zużywać płatne tokeny bez równie długiej widocznej odpowiedzi. Koszty indeksowania i koszty rozmów są różne. Używaj aktualnych cen, a nie stałego numeru z kursu. Prosty szacunek to tokeny/1 000 000 × cena plus dodatkowe operacje; Kredyty aplikacyjne mogą mieć własną konwersję. Porównaj koszt udanego zadania, a nie tylko połączenia. Wykonywanie równoległe może zmniejszyć opóźnienia, jednocześnie zwiększając całkowite zużycie. Budżet wymaga zweryfikowanego warunku zatrzymania.

Schemat objaśniający

Postępuj zgodnie ze strzałkami wskazującymi główny przepływ. Przerywane niebieskie strzałki przedstawiają dane lub kontekst; przerywane różowe strzałki pokazują opinie lub zwracane wyniki. Kolory i kształty wyróżniają modele, sklepy, decyzje i wyniki. Na małym ekranie przewijaj w poziomie, aby zobaczyć cały schemat.

Kompletny przykład

Widget określa swoją rolę, działa na dozwolonych domenach i wykorzystuje testowany cel. Sprawdź źródła, błędy, telefon komórkowy i koszty, a następnie określ, kto sprawdza zasady.

Spróbuj sam

1. Pełna kontrola dostępu, jakości, domeny, urządzeń mobilnych, budżetu i konserwacji przed publikacją.
2. Przed rozpoczęciem eksperymentu zapisz dane wejściowe, źródło i oczekiwany wynik. W przykładzie użyj wyłącznie fikcyjnych danych.
3. Postępuj zgodnie z etapami diagramu. Na każdym etapie zapisuj, jakie informacje zostały otrzymane i wyprodukowane; nie myl produktu pośredniego z efektem końcowym.
4. Powtórz po usunięciu niezbędnych informacji lub wprowadzeniu niejednoznaczności. Sprawdź, czy system wyjaśnia, zatrzymuje lub wymyśla odpowiedź.
5. Porównaj z objaśnionym rozwiązaniem. Zachowaj konfigurację, datę, wynik i wyjaśnienie różnic. Zmień jedną rzecz i przetestuj ponownie.

Wyjaśnione rozwiązanie

Dostarcz integrację, dozwolone/zakazane testy, kryteria uruchomienia i datę przeglądu. Pomyślne ćwiczenie pozwala pokazać związek między danymi wejściowymi, etapami i wynikiem. Gdy brakuje informacji, bardziej użyteczna jest ostrożna odpowiedź niż wymyślane szczegóły. Porównaj więcej niż styl: sprawdź także warunki, źródła i operacje.

Kiedy to podejście pomaga i jakie ma ograniczenia

Nie obiecuj odwiedzającym niepotwierdzonych funkcji planowania lub zatwierdzania. Wybierz to podejście, jeśli poprawia ono zmierzoną potrzebę. Zachowaj prostą linię bazową i porównaj wyniki, korzystając z identycznych danych wejściowych. Jeden udany przykład nie gwarantuje niezawodności w każdej sytuacji.

Sprawdź swoją wiedzę

Dlaczego usunięcie prywatnego źródła po udzieleniu odpowiedzi jest zbyt późne?

Dane weszły już w kontekst modelu i mogą zostać ujawnione.

Czy przekroczenie limitu czasu oznacza, że ​​operacja nie została wykonana?

Nie. Sprawdź stan przed ponowną próbą działania ze skutkami ubocznymi.

Jaki wynik powinno dać to ćwiczenie?

Dostarcz integrację, dozwolone/zakazane testy, kryteria uruchomienia i datę przeglądu.

Pojęcia do zapamiętania

• Autoryzacja / Autoryzacja: Sprawdzanie prawa dostępu do operacji lub zasobu.
• Idempotencja: Kontrolowane powtarzanie bez powielania efektu.
• Latență / Opóźnienie: Czas do użytecznego wyniku.

Źródła i następny krok

• OWASP — Wstrzykiwanie instrukcji
• LangGraph — Przepływy pracy i agenci
• OpenRouter — tokeny rozumowania

Aby przygotować: A03 — Agent połączony z wiedzą · R03 — Naiwny RAG: Twój poziom wyjściowy · D04 — Dobre pytania do testowania RAG · U02 — Plac zabaw jako laboratorium · U05 — Widżet AI na Twojej stronie internetowej · E05 — Tokeny, kredyty, budżety i całkowity koszt · S01 — Natychmiastowe wstrzyknięcie i niezaufane dane · S02 — Uprawnienia i ochrona danych