9 listopada 2026 r. AWS ogłosiło, że Amazon Bedrock Managed Knowledge Base obsługuje przez API AgenticRetrieveStream trzy sposoby pracy: pobieranie fragmentów bez generowania odpowiedzi, RAG w jednym przebiegu oraz wieloetapowe wyszukiwanie agentowe. O tym, który wariant wykona dla danego zapytania, decyduje aplikacja, ustawiając maxAgentIteration (ogłoszenie AWS).
RAG, czyli generowanie wspomagane wyszukiwaniem, polega na pobraniu materiałów z bazy wiedzy i użyciu ich jako kontekstu odpowiedzi modelu. Nowe ustawienia pozwalają aplikacji wybrać, czy ma zwrócić same znalezione fragmenty, od razu wygenerować odpowiedź, czy dać modelowi możliwość rozłożenia złożonego pytania na podzapytania i ponownego wyszukiwania.
Dobieraj liczbę iteracji do zadania: proste pytanie może wymagać jednego wyszukania, a pytanie łączące kilka dokumentów — kolejnych rund sprawdzania kontekstu.
Co oznaczają wartości maxAgentIteration
AWS przypisało wartości od 0 do 5 do trzech różnych przebiegów. Wartość 0 zwraca znalezione fragmenty bez wywołania modelu fundacyjnego; wartość 1 oznacza jedno wyszukanie i wygenerowanie odpowiedzi; zakres 2–5 pozwala na wieloetapowe wyszukiwanie agentowe. „Jedno przejście” oznacza tu jedno wyszukanie, a nie użycie tylko jednej bazy wiedzy — tryby mogą korzystać z wielu baz (opis trybów AWS).
Tryb i wartość maxAgentIteration | Działanie | Generowanie odpowiedzi | Kiedy pasuje |
Samo pobieranie — 0 | Jedno wyszukanie; bez wywołania modelu fundacyjnego | Wyłączone: generateResponse=false | Gdy aplikacja ma zwrócić lub samodzielnie przetworzyć znalezione fragmenty |
RAG w jednym przebiegu — 1 | Jedno wyszukanie, po którym model generuje odpowiedź | Włączone; bez rund planowania | Przy bezpośrednich pytaniach, na które powinno wystarczyć jedno wyszukanie |
Wyszukiwanie agentowe — 2–5 | Model może planować podzapytania, ponawiać wyszukiwanie i oceniać zebrane informacje | Przy włączonym generowaniu ostatnie wywołanie służy odpowiedzi; wcześniej może odbyć się do n−1 rund planowania | Przy pytaniach wielowątkowych lub wymagających informacji z kilku dokumentów |
Przy wartości 0 trzeba ustawić generateResponse=false; próba włączenia generowania kończy się błędem 4xx. Przy wartości 1 pojedyncza iteracja oznacza wywołanie modelu generującego odpowiedź, bez rund planowania. Wartości od 2 do 5 zachowują wyszukiwanie agentowe: jedna iteracja odpowiada jednemu wywołaniu modelu, a początkowe wyszukanie spekulacyjne nie wlicza się do limitu. Gdy generowanie jest włączone, ostatnie wywołanie jest przeznaczone na odpowiedź, dlatego przy limicie n pozostaje do n−1 rund planowania.
Co aplikacja musi przekazać i odebrać
Żądanie AgenticRetrieveStream wymaga konfiguracji agenticRetrieveConfiguration, co najmniej jednej wiadomości w messages i co najmniej jednego elementu retrievers (dokumentacja API). W trybie samego pobierania fragmenty trafiają do zdarzenia strumienia result; ten wynik nie zawiera pól score ani location. Odpowiedź wygenerowana przez model może zawierać cytowania łączące jej fragmenty z pobranymi wynikami.
Przewodnik AWS opisuje wyszukiwanie agentowe dla w pełni zarządzanych baz wiedzy Amazon Bedrock i dopuszcza do pięciu retrieverów w jednym żądaniu. W przykładzie wymaganych uprawnień dla tego przepływu AWS wymienia bedrock:AgenticRetrieveStream, bedrock:Retrieve, bedrock:GetDocumentContent oraz bedrock:InvokeModelWithResponseStream (przewodnik AWS). Są to informacje dotyczące integracji z wyszukiwaniem agentowym; przy wartości maxAgentIteration=0 API nie wywołuje modelu fundacyjnego.
Jak sprawdzić, który tryb pasuje do zapytań
AWS zaleca sprawdzić tryby na reprezentatywnych pytaniach i oczekiwanych odpowiedziach, korzystając z tej samej bazy wiedzy. Warto uwzględnić pytania, które wymagają połączenia kilku dokumentów, oraz takie, na które baza nie powinna udzielić odpowiedzi. Zespół może wtedy ocenić poprawność odpowiedzi i jej oparcie w pobranych fragmentach, a także zmierzyć opóźnienie i koszt żądania.
Przy prostych pytaniach można porównać tryb 1 z wyszukiwaniem agentowym, a przy pytaniach wielodokumentowych sprawdzić, czy dodatkowe rundy rzeczywiście pomagają. AWS wskazuje, że ograniczenie liczby iteracji może sprawić, że wyszukiwanie agentowe zakończy się wcześniej i potencjalnie obniżyć trafność przy złożonych pytaniach (przewodnik AWS). AWS ocenia też, że RAG w jednym przebiegu może skrócić opóźnienie i zmniejszyć użycie modeli w porównaniu z trybem agentowym; nie podaje jednak pomiarów określających skalę tej różnicy (ogłoszenie AWS).