AI-translated from English; not yet reviewed by a fluent editor. # Napravite Claude tok rada za paralelni pregled dokumenata > Anthropic-ov Managed Agents u beta verziji može da pretvori pregled dokumenata u tok rada sa više faza. Ovaj vodič pokazuje kako da podesite pokretanje, pregledate njegove događaje i izlaz i uzmete u obzir troškove i ograničenja. By BIG CHANGE Editorial Published: 2026-10-09T20:34:58.333Z Updated: 2026-10-09T20:34:58.333Z Canonical: https://bigchange.ai/blog/claude-managed-agents-parallel-document-review-guide ![One reader sits at a laptop with text on screen; a page with faint text lines lies on the table beside it.](https://bigchange.ai/api/media/file/claude-managed-agents-document-review-hero-v1.png) Conceptual illustration of a reader manually checking a proposed document-review report. It is not a Claude product screenshot or a BIG CHANGE hands-on test. AI-generated illustration by BIG CHANGE. Claude Managed Agents sada može da napiše program toka rada koji dodeljuje delove velikog zadatka većem broju agenata, prikuplja njihove nalaze i objedinjuje ih. Funkcija je u beta verziji. Evo dokumentovanog postupka za programera koji želi da pregleda fasciklu dokumenata i napravi proverenu datoteku nalaza. Ovo koristi Anthropic-ov Claude Platform API i CLI. BIG CHANGE je pregledao aktuelnu dokumentaciju; nismo pokrenuli podešavanje niti testirali tok rada. ## Šta tok rada radi Jedan [dinamički tok rada](https://platform.claude.com/docs/en/managed-agents/workflow-runs) je program za jedno pokretanje. Program može da podeli posao u faze, pokrene niti agenata paralelno, prenosi njihove rezultate između faza, ponovi neuspelu granu ili njom upravlja i spoji rezultate. Na primer, prva faza može da pregleda zasebne datoteke, dok kasnija usklađuje nalaze. Primarni agent pokreće tok; server ga izvršava u pozadini. To se razlikuje od zahteva da glavni agent napravi odvojena pokretanja. Pokretanje toka koordiniše podređene niti u okviru jednog pokretanja i vraća rezultat agentu koji ga je započeo. Obična poruka sesije sama po sebi ne započinje pokretanje; agent odlučuje kada će ga pokrenuti na osnovu zadatka i sistemskog uputstva. Anthropic navodi da sesija može imati nekoliko otvorenih pokretanja, ali svako ima sopstvene faze i ishod. ## Pre početka Potrebni su vam Claude Console nalog, API ključ i pristup Claude Managed Agents-u, za koji Anthropic kaže da je podrazumevano omogućen za API naloge. Krajnje tačke za agente i tokove zahtevaju zaglavlje `managed-agents-2026-04-01` beta. Anthropic-ov SDK to zaglavlje podešava automatski; ako API pozivate bez SDK-a, dodajte ga sami. Managed Agents je u aktuelnoj dokumentaciji i dalje označen kao [beta](https://platform.claude.com/docs/en/managed-agents/overview). Anthropic-ove [napomene o izdanju](https://platform.claude.com/docs/en/release-notes/overview) datiraju javnu beta verziju na 9. april 2026, orkestraciju više agenata na 11. maj, a dinamičke tokove na 9. oktobar. I dinamički tokovi su u beta verziji. Datum je važan: brojka „1.000 agenata“ predstavlja trenutno ograničenje za ceo tok, a ne novu mogućnost istovremenog pokretanja 1.000 agenata. Platforma na serveru čuva istoriju razgovora sesije, stanje okruženja i izlaze. Anthropic kaže da Managed Agents trenutno ne ispunjava uslove za pokriće [Zero Data Retention-a niti HIPAA ugovora o poslovnom saradniku](https://platform.claude.com/docs/en/managed-agents/overview). Ne stavljajte regulisan ili poverljiv materijal u sesiju dok vaša organizacija ne potvrdi primenljiva pravila o podacima i podešavanje. ## 1. Instalirajte CLI i SDK Instalirajte Anthropic-ov `ant` CLI metodom za svoj operativni sistem iz [brzog vodiča za Managed Agents](https://platform.claude.com/docs/en/managed-agents/quickstart). Na primer, dokumentovana komanda za macOS glasi: ```sh brew install anthropics/tap/ant ``` Za Python instalirajte SDK i prosledite API ključ preko okruženja, umesto da ga unosite u izvornu datoteku: ```sh pip install anthropic export ANTHROPIC_API_KEY="your-api-key" ``` Ključ iznad je zamenski primer. Stvarnu vrednost čuvajte u uobičajenom menadžeru tajni ili zaštićenoj konfiguraciji okruženja. ## 2. Definišite agenta koji može da koristi tokove Napravite `document-reviewer.md`. Blok `multiagent` omogućava oktobarski tip toka. Isključivanje podagenata čini izabrani put delegiranja izričitim: ovaj agent koristi dinamičke tokove, a ne pojedinačno delegiranje podagentu. ```yaml --- name: document-reviewer model: claude-sonnet-5-5 tools: - type: agent_toolset_20260401 multiagent: type: multiagent_20261001 subagents: type: disabled workflows: type: enabled --- You review documents for a user-defined checklist. When a request contains more than 20 independent files, use a dynamic workflow. Make one phase that checks the files independently and a later phase that reconciles duplicate findings. Do not infer missing facts. Save the final machine-readable results to report.json and a concise explanation to summary.md. Include the source filename and a short evidence excerpt for every finding. If a file cannot be read or a worker fails, record that file as unresolved; do not silently omit it. The final response must report the number of files reviewed, unresolved files, and whether every output file was written. ``` Prag i uputstva za pregled su vaše izbore politike, a ne Anthropic-ove podrazumevane vrednosti. Prilagodite ih poslu i ceni grešaka. `claude-sonnet-5-5` je primer ID-a modela; izaberite model koji je trenutno dostupan vašem nalogu i budžetu. Napravite agenta i sačuvajte vraćeni ID: ```sh ant apply document-reviewer.md ``` CLI ispisuje ID agenta i beleži ga u `claude-lock.json`. Managed Agents razdvaja ponovo upotrebljivu definiciju agenta (model, uputstva i alate) od okruženja u kom se sesija izvršava. ## 3. Podesite okruženje Okruženje određuje gde se sesije izvršavaju: u Anthropic-ovom oblačnom okruženju ili u sopstvenom okruženju na vašoj infrastrukturi. Oblačni primer iz brzog vodiča koristi ograničenu mrežu i dozvoljava menadžere paketa: ```yaml # environment.yaml name: document-review config: type: cloud networking: type: limited allow_package_managers: true ``` Primenite ga komandom `ant apply environment.yaml`; njegov ID se takođe čuva u `claude-lock.json`. Ako agentu treba pristup mreži, navedite samo neophodne hostove u `allowed_hosts`. Sa ograničenom mrežom, ta lista ograničava i alate za veb pretragu i preuzimanje u Managed Agents-u. Podešavanje koje dozvoljava menadžere paketa ne dodaje veb-sajtove na listu dozvoljenih. Za prvo pokretanje koristite malu fasciklu bez osetljivih podataka i samo neophodne alate. Ugrađeni skup alata agenta obuhvata komande okruženja i rad sa datotekama; dodavanje alata može da proširi ono što agent može da radi. Pregledajte dokumentovanu politiku dozvola i kontrole okruženja pre nego što odobrite pristup spoljnim sistemima ili akreditivima. ## 4. Pokrenite sesiju i pošaljite ograničen zadatak Upotrebite ID agenta i okruženja da napravite sesiju pomoću Python SDK-a: ```python import anthropic client = anthropic.Anthropic() session = client.beta.sessions.create( agent="AGENT_ID_FROM_CLAUDE_LOCK", environment_id="ENVIRONMENT_ID_FROM_CLAUDE_LOCK", title="Small document review", ) print(session.id) ``` Zamenite dva zamenska ID-a vrednostima iz `claude-lock.json`. Zatim pošaljite konkretan zadatak preko toka događaja sesije. Pokrenite tok pre slanja događaja da biste pratili pokretanje i napredak dok pristižu: ```python with client.beta.sessions.events.stream(session.id) as stream: client.beta.sessions.events.send( session.id, events=[{ "type": "user.message", "content": [{ "type": "text", "text": ( "Review each Markdown file in /review-set for a missing " "owner, deadline, or acceptance criterion. Quote evidence; " "do not infer missing details. Reconcile duplicate findings " "and write /mnt/session/outputs/report.json plus " "/mnt/session/outputs/summary.md. In report.json, use " "a files array with one record per input: path, status " "(reviewed or unresolved), and findings; each finding has " "a check, evidence excerpt, and source location. Include " "input, reviewed, and unresolved counts." ), }], }], ) open_runs = {} run_results = {} for event in stream: if event.type == "workflow_run.created": open_runs[event.workflow_run_id] = event.name print(f"Run started: {event.name}") elif event.type == "workflow_run.status_ended": run_results[event.workflow_run_id] = event.result.type open_runs.pop(event.workflow_run_id, None) print(f"Run ended: {event.result.type}") elif event.type == "workflow_run.error": print(f"Run error: {event.error}") elif event.type == "agent.message": for block in event.content: if block.type == "text": print(block.text) elif event.type == "session.status_idle": if event.stop_reason.type == "end_turn" and not open_runs: break # Inspect the child threads associated with completed workflow runs. for thread in client.beta.sessions.threads.list(session.id): if thread.workflow_run_id in run_results: print(f"Thread {thread.id}: {thread.status}") for thread_event in client.beta.sessions.threads.events.list( thread.id, session_id=session.id ): if thread_event.type == "session.error": print(f"Thread error: {thread_event}") ``` Ovaj primer pretpostavlja da konfigurisani način unosa u sesiju izlaže datoteke na lokaciji `/review-set`. Postavite datoteke u okruženje sesije dokumentovanim načinom unosa pre nego što zatražite pregled. Za izlaze tražite od agenta da upisuje u `/mnt/session/outputs/`; [dokumentacija za datoteke u Managed Agents-u](https://platform.claude.com/docs/en/managed-agents/files) objašnjava kako da izlista datoteke ograničene na sesiju i preuzme ih. U Python SDK-u dokumentovani oblik čitanja je: ```python files = client.beta.files.list( scope_id=session.id, betas=["managed-agents-2026-04-01"], ) for report in files: if report.filename == "report.json": content = client.files.download(report.id) content.write_to_file("report.json") break ``` Datoteci može biti potrebno nekoliko sekundi da se pojavi pošto sesija postane neaktivna; ako nedostaje, ponovo je izlistajte posle kratkog čekanja. Za bezbednu prvu proveru napravite probnu fasciklu sa nekoliko dokumenata čije očekivane nalaze možete ručno da pregledate. Primer uputstva definiše zadatak pregleda, ali ne garantuje da će agent pronaći svaki problem. Ugovor o izlazu treba da bude dovoljno strog za reviziju. Na primer: ```json { "files": [ { "path": "requirements.md", "status": "reviewed", "findings": [ { "check": "deadline", "evidence_excerpt": "...", "source_location": "requirements.md, section 2" } ] } ], "input_count": 1, "reviewed_count": 1, "unresolved_count": 0 } ``` Ovo je predložena šema za vaš tok rada, a ne šema koju je obezbedio Anthropic. Nerazjašnjene ili nečitljive datoteke zadržite kao zapise kako odsustvo rezultata ne bi izgledalo kao uspešan pregled. ## 5. Proverite pokretanje i njegov izlaz Kada se tok pokrene, tok događaja javlja `workflow_run.created`, uključujući ID pokretanja i faze definisane tokom. Primer drži svaki ID otvorenim do odgovarajućeg događaja `workflow_run.status_ended`; neaktivnost glavne sesije sama po sebi ne znači da je pozadinski tok završen. Glavni tok sažima status podređenih niti, dok lista događaja pojedinačne niti sadrži njene poruke i greške. Primer izlistava niti prema `workflow_run_id` i prikazuje događaje `session.error` . Pregledajte ih zbog iscrpljenih ponovnih pokušaja (uključujući `retry_status.type == "exhausted"`) ili drugih grešaka podređenih niti i označite pogođene datoteke kao nerazjašnjene. Tretirajte izlaznu datoteku kao isporučeni rezultat, a ne reč „završeno“. Anthropic izričito upozorava da se pokretanje može završiti statusom `completed` čak i ako je rad na niti propao ili nit nije mogla da bude napravljena. Otvorite `report.json` i proverite da svaka ulazna datoteka ima nalaze ili izričit status nerazjašnjenog slučaja, da se izvodi dokaza odnose na tačnu izvornu datoteku i da se brojevi poklapaju sa dostavljenim datotekama. Uporedite malu probnu fasciklu sa očekivanim rezultatima pre nego što tok upotrebite nad većim korpusom. Ako se klijent prekine, novi tok događaja šalje samo događaje nastale posle njegovog otvaranja. Obnovite stanje pokretanja izlistavanjem prethodnih događaja sesije pomoću dokumentovanih filtera tipa događaja i praćenjem straničenja. Ne zaključujte da je pokretanje završeno samo zato što je primarni agent neaktivan, dok podređene niti možda i dalje rade. Kada se završe sva posmatrana pokretanja, izlistajte datoteke ograničene na sesiju i preuzmite `/mnt/session/outputs/report.json` i `summary.md` pomoću dokumentovanog Files API-ja. Proverite da svaka dostavljena datoteka ima pregledan ili nerešen zapis i da se brojevi slažu. Primer petlje događaja ne preuzima niti proverava izveštaj. ## Ograničenja koja utiču na dizajn Anthropic-ova trenutna [ograničenja pokretanja tokova](https://platform.claude.com/docs/en/managed-agents/workflow-runs) dokumentuju do 64 niti toka koje istovremeno rade u jednom pokretanju, ali navode da API ne garantuje tu konkurentnost i da se vrednost može promeniti. Ograničenje od 1.000 agenata broji agente pokrenute tokom celog trajanja pokretanja; to nije broj istovremenih niti. Ako tok zatraži još jednog agenta nakon dostizanja tog ukupnog broja, pokretanje se završava sa statusom `thread_limit_error`; ponovni pokušaji neuspelih agenata mogu napraviti dodatne niti. Pokretanje podrazumevano traje 24 sata ili kraće ako agent podesi manje trajanje. Računa se i vreme čekanja vašeg klijenta, a pauzirano pokretanje i dalje može da istekne. Sesija podrazumevano ima 10 otvorenih pokretanja, uključujući neaktivna. Budžet upotrebe sesije važi za sve agente toka; kada se dostigne, otvorena pokretanja se pauziraju dok se budžet ne poveća ili ukloni. Planirajte manje radne celine, čuvajte kontrolne tačke u datotekama i neka faza usklađivanja prijavi nedovršene stavke umesto da se pretvara da su pregledane. Kod grešaka pregledajte `workflow_run.error` i pogođenu nit. `program_error` može da znači da su otkazali kod toka ili podređeni agent; `thread_limit_error` označava ograničenje od 1.000 agenata; `timeout_error` označava trajanje pokretanja. Ako pokretanje dostigne budžet sesije, povećajte ili uklonite budžet da biste ga nastavili. Ako treba da zaustavite tok, zatražite od primarnog agenta da zaustavi pokretanja; prekid obrta sesije sam po sebi nije komanda za otkazivanje pokretanja. ## Troškovi Anthropic-ova [dokumentacija o cenama](https://platform.claude.com/docs/en/about-claude/pricing) naplaćuje tokene modela u Managed Agents-u po tarifi izabranog modela, a vreme sesije po ceni od **0,08 $ za sat aktivne sesije**. Vreme se obračunava dok je status sesije `running`; ne računaju se neaktivnost, ponovno zakazivanje i prekinuto vreme. Pokretanje toka nema posebnu naknadu, ali se tokeni niti naplaćuju kao deo sesije. Veb pretraga unutar sesije navedena je po ceni od 10 $ za 1.000 pretraga. Tačan ukupan trošak zavisi od modela, ulaznih i izlaznih tokena, alata i trajanja sesije; proverite upotrebu u Console-u umesto da je procenjujete na osnovu ograničenja od 1.000 agenata. Praktično podešavanje počinje sa nekoliko datoteka: proverite da li izlaz toka obuhvata svaku, pregledajte neuspele niti, pa proširite ulaz tek kada su politika pregleda i trošak prihvatljivi. Upravljani tokovi koordinišu asinhroni paralelni rad; oni ne potvrđuju tačnost nalaza. ## Najveća promena Od 9. oktobra agent Managed Agents-a može da napiše program toka koji server izvršava kroz više niti agenata i faza. Programeri mogu da koriste taj put za ograničeno i proverljivo raspoređivanje posla dok glavna sesija prati napredak. Funkcija je i dalje u beta verziji, a objavljena ograničenja ne garantuju da će svako pokretanje dostići najveću konkurentnost ili dati tačne nalaze. ## Izvori i dodatno čitanje - [Pregled Claude Managed Agents-a](https://platform.claude.com/docs/en/managed-agents/overview) — beta status, API zaglavlje, pristup, sesije sa stanjem, alati i ograničenja čuvanja podataka. - [Početak rada sa Claude Managed Agents-om](https://platform.claude.com/docs/en/managed-agents/quickstart) — podešavanje CLI-ja i SDK-a, agenta i okruženja, kreiranje sesije i primer toka događaja. - [Orkestracija više agenata](https://platform.claude.com/docs/en/managed-agents/multiagent-orchestration) — uključivanje dinamičkih tokova i izbor između tokova i podagenata. - [Pokretanja tokova](https://platform.claude.com/docs/en/managed-agents/workflow-runs) — događaji pokretanja, tumačenje rezultata, oporavak, budžeti i dokumentovana ograničenja. - [Niti sesije](https://platform.claude.com/docs/en/managed-agents/session-threads) — izlistavanje podređenih niti povezanih sa pokretanjem i čitanje njihove istorije događaja. - [Datoteke sesije](https://platform.claude.com/docs/en/managed-agents/files) — montirani ulazi, putanje izlaza, izlistavanje i preuzimanje datoteka sesije. - [Napomene o izdanjima Claude Platform-a](https://platform.claude.com/docs/en/release-notes/overview) — ažuriranje dinamičkih tokova od 9. oktobra 2026. i beta podešavanje. - [Cene Claude Platform-a](https://platform.claude.com/docs/en/about-claude/pricing) — naplata tokena i tarife za vreme sesije. ## Sources - [Pregled Claude Managed Agents-a](https://platform.claude.com/docs/en/managed-agents/overview) — Trenutni beta status, API zaglavlje, pristup, sesije sa stanjem i ograničenja čuvanja podataka. - [Početak rada sa Claude Managed Agents-om](https://platform.claude.com/docs/en/managed-agents/quickstart) — Podešavanje CLI-ja i SDK-a, agenta i okruženja, primeri sesije i toka događaja. - [Orkestracija više agenata](https://platform.claude.com/docs/en/managed-agents/multiagent-orchestration) — Omogućavanje tokova i razlika u odnosu na podagente. - [Pokretanja tokova](https://platform.claude.com/docs/en/managed-agents/workflow-runs) — Mehanika tokova i pokretanja, događaji, tumačenje stanja izlaza, oporavak, budžeti i ograničenja. - [Napomene o izdanjima Claude Platform-a](https://platform.claude.com/docs/en/release-notes/overview) — Datirana istorija javne beta verzije i ažuriranje dinamičkih tokova od 9. oktobra 2026; ispravljeni kanonski URL. - [Cene Claude Platform-a](https://platform.claude.com/docs/en/about-claude/pricing) — Cene tokena i vremena sesije u Managed Agents-u. - [Niti sesije](https://platform.claude.com/docs/en/managed-agents/session-threads) — Izlistavanje podređenih niti povezanih sa pokretanjem i čitanje njihovih istorija događaja. - [Datoteke sesije](https://platform.claude.com/docs/en/managed-agents/files) — Montirani ulazi, putanje izlaza, izlistavanje i preuzimanje datoteka sesije.