Markdown издање

AI-translated from English; not yet reviewed by a fluent editor.

# Направите Claude ток рада за паралелни преглед докумената

> Anthropic-ов Managed Agents у бета верзији може да претвори преглед докумената у ток рада са више фаза. Овај водич показује како да подесите покретање, прегледате његове догађаје и излаз и узмете у обзир трошкове и ограничења.

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 сада може да напише програм тока рада који додељује делове великог задатка већем броју агената, прикупља њихове налазе и обједињује их. Функција је у бета верзији. Ево документованог поступка за програмера који жели да прегледа фасциклу докумената и направи проверену датотеку налаза.

Ово користи Anthropic-ов Claude Platform API и CLI. BIG CHANGE је прегледао актуелну документацију; нисмо покренули подешавање нити тестирали ток рада.

## Шта ток рада ради

Један [динамички ток рада](https://platform.claude.com/docs/en/managed-agents/workflow-runs) је програм за једно покретање. Програм може да подели посао у фазе, покрене нити агената паралелно, преноси њихове резултате између фаза, понови неуспелу грану или њом управља и споји резултате. На пример, прва фаза може да прегледа засебне датотеке, док каснија усклађује налазе. Примарни агент покреће ток; сервер га извршава у позадини.

То се разликује од захтева да главни агент направи одвојена покретања. Покретање тока координише подређене нити у оквиру једног покретања и враћа резултат агенту који га је започео. Обична порука сесије сама по себи не започиње покретање; агент одлучује када ће га покренути на основу задатка и системског упутства. Anthropic наводи да сесија може имати неколико отворених покретања, али свако има сопствене фазе и исход.

## Пре почетка

Потребни су вам Claude Console налог, API кључ и приступ Claude Managed Agents-у, за који Anthropic каже да је подразумевано омогућен за API налоге. Крајње тачке за агенте и токове захтевају заглавље `managed-agents-2026-04-01` бета. Anthropic-ов SDK то заглавље подешава аутоматски; ако API позивате без SDK-а, додајте га сами.

Managed Agents је у актуелној документацији и даље означен као [бета](https://platform.claude.com/docs/en/managed-agents/overview). Anthropic-ове [напомене о издању](https://platform.claude.com/docs/en/release-notes/overview) датирају јавну бета верзију на 9. април 2026, оркестрацију више агената на 11. мај, а динамичке токове на 9. октобар. И динамички токови су у бета верзији. Датум је важан: бројка „1.000 агената“ представља тренутно ограничење за цео ток, а не нову могућност истовременог покретања 1.000 агената.

Платформа на серверу чува историју разговора сесије, стање окружења и излазе. Anthropic каже да Managed Agents тренутно не испуњава услове за покриће [Zero Data Retention-а нити HIPAA уговора о пословном сараднику](https://platform.claude.com/docs/en/managed-agents/overview). Не стављајте регулисан или поверљив материјал у сесију док ваша организација не потврди применљива правила о подацима и подешавање.

## 1. Инсталирајте CLI и SDK

Инсталирајте Anthropic-ов `ant` CLI методом за свој оперативни систем из [брзог водича за Managed Agents](https://platform.claude.com/docs/en/managed-agents/quickstart). На пример, документована команда за macOS гласи:

```sh
brew install anthropics/tap/ant
```

За Python инсталирајте SDK и проследите API кључ преко окружења, уместо да га уносите у изворну датотеку:

```sh
pip install anthropic
export ANTHROPIC_API_KEY="your-api-key"
```

Кључ изнад је заменски пример. Стварну вредност чувајте у уобичајеном менаџеру тајни или заштићеној конфигурацији окружења.

## 2. Дефинишите агента који може да користи токове

Направите `document-reviewer.md`. Блок `multiagent` омогућава октобарски тип тока. Искључивање подагената чини изабрани пут делегирања изричитим: овај агент користи динамичке токове, а не појединачно делегирање подагенту.

```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.
```

Праг и упутства за преглед су ваше изборе политике, а не Anthropic-ове подразумеване вредности. Прилагодите их послу и цени грешака. `claude-sonnet-5-5` је пример ID-а модела; изаберите модел који је тренутно доступан вашем налогу и буџету.

Направите агента и сачувајте враћени ID:

```sh
ant apply document-reviewer.md
```

CLI исписује ID агента и бележи га у `claude-lock.json`. Managed Agents раздваја поново употребљиву дефиницију агента (модел, упутства и алате) од окружења у ком се сесија извршава.

## 3. Подесите окружење

Окружење одређује где се сесије извршавају: у Anthropic-овом облачном окружењу или у сопственом окружењу на вашој инфраструктури. Облачни пример из брзог водича користи ограничену мрежу и дозвољава менаџере пакета:

```yaml
# environment.yaml
name: document-review
config:
  type: cloud
  networking:
    type: limited
    allow_package_managers: true
```

Примените га командом `ant apply environment.yaml`; његов ID се такође чува у `claude-lock.json`. Ако агенту треба приступ мрежи, наведите само неопходне хостове у `allowed_hosts`. Са ограниченом мрежом, та листа ограничава и алате за веб претрагу и преузимање у Managed Agents-у. Подешавање које дозвољава менаџере пакета не додаје веб-сајтове на листу дозвољених.

За прво покретање користите малу фасциклу без осетљивих података и само неопходне алате. Уграђени скуп алата агента обухвата команде окружења и рад са датотекама; додавање алата може да прошири оно што агент може да ради. Прегледајте документовану политику дозвола и контроле окружења пре него што одобрите приступ спољним системима или акредитивима.

## 4. Покрените сесију и пошаљите ограничен задатак

Употребите ID агента и окружења да направите сесију помоћу Python SDK-а:

```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)
```

Замените два заменска ID-а вредностима из `claude-lock.json`. Затим пошаљите конкретан задатак преко тока догађаја сесије. Покрените ток пре слања догађаја да бисте пратили покретање и напредак док пристижу:

```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}")
```

Овај пример претпоставља да конфигурисани начин уноса у сесију излаже датотеке на локацији `/review-set`. Поставите датотеке у окружење сесије документованим начином уноса пре него што затражите преглед. За излазе тражите од агента да уписује у `/mnt/session/outputs/`; [документација за датотеке у Managed Agents-у](https://platform.claude.com/docs/en/managed-agents/files) објашњава како да излиста датотеке ограничене на сесију и преузме их. У Python SDK-у документовани облик читања је:

```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
```

Датотеци може бити потребно неколико секунди да се појави пошто сесија постане неактивна; ако недостаје, поново је излистајте после кратког чекања. За безбедну прву проверу направите пробну фасциклу са неколико докумената чије очекиване налазе можете ручно да прегледате. Пример упутства дефинише задатак прегледа, али не гарантује да ће агент пронаћи сваки проблем.

Уговор о излазу треба да буде довољно строг за ревизију. На пример:

```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
}
```

Ово је предложена шема за ваш ток рада, а не шема коју је обезбедио Anthropic. Неразјашњене или нечитљиве датотеке задржите као записе како одсуство резултата не би изгледало као успешан преглед.

## 5. Проверите покретање и његов излаз

Када се ток покрене, ток догађаја јавља `workflow_run.created`, укључујући ID покретања и фазе дефинисане током. Пример држи сваки ID отвореним до одговарајућег догађаја `workflow_run.status_ended`; неактивност главне сесије сама по себи не значи да је позадински ток завршен. Главни ток сажима статус подређених нити, док листа догађаја појединачне нити садржи њене поруке и грешке. Пример излистава нити према `workflow_run_id` и приказује догађаје `session.error` . Прегледајте их због исцрпљених поновних покушаја (укључујући `retry_status.type == "exhausted"`) или других грешака подређених нити и означите погођене датотеке као неразјашњене.

Третирајте излазну датотеку као испоручени резултат, а не реч „завршено“. Anthropic изричито упозорава да се покретање може завршити статусом `completed` чак и ако је рад на нити пропао или нит није могла да буде направљена. Отворите `report.json` и проверите да свака улазна датотека има налазе или изричит статус неразјашњеног случаја, да се изводи доказа односе на тачну изворну датотеку и да се бројеви поклапају са достављеним датотекама. Упоредите малу пробну фасциклу са очекиваним резултатима пре него што ток употребите над већим корпусом.

Ако се клијент прекине, нови ток догађаја шаље само догађаје настале после његовог отварања. Обновите стање покретања излиставањем претходних догађаја сесије помоћу документованих филтера типа догађаја и праћењем страничења. Не закључујте да је покретање завршено само зато што је примарни агент неактиван, док подређене нити можда и даље раде. Када се заврше сва посматрана покретања, излистајте датотеке ограничене на сесију и преузмите `/mnt/session/outputs/report.json` и `summary.md` помоћу документованог Files API-ја. Проверите да свака достављена датотека има прегледан или нерешен запис и да се бројеви слажу. Пример петље догађаја не преузима нити проверава извештај.

## Ограничења која утичу на дизајн

Anthropic-ова тренутна [ограничења покретања токова](https://platform.claude.com/docs/en/managed-agents/workflow-runs) документују до 64 нити тока које истовремено раде у једном покретању, али наводе да API не гарантује ту конкурентност и да се вредност може променити. Ограничење од 1.000 агената броји агенте покренуте током целог трајања покретања; то није број истовремених нити. Ако ток затражи још једног агента након достизања тог укупног броја, покретање се завршава са статусом `thread_limit_error`; поновни покушаји неуспелих агената могу направити додатне нити.

Покретање подразумевано траје 24 сата или краће ако агент подеси мање трајање. Рачуна се и време чекања вашег клијента, а паузирано покретање и даље може да истекне. Сесија подразумевано има 10 отворених покретања, укључујући неактивна. Буџет употребе сесије важи за све агенте тока; када се достигне, отворена покретања се паузирају док се буџет не повећа или уклони. Планирајте мање радне целине, чувајте контролне тачке у датотекама и нека фаза усклађивања пријави недовршене ставке уместо да се претвара да су прегледане.

Код грешака прегледајте `workflow_run.error` и погођену нит. `program_error` може да значи да су отказали код тока или подређени агент; `thread_limit_error` означава ограничење од 1.000 агената; `timeout_error` означава трајање покретања. Ако покретање достигне буџет сесије, повећајте или уклоните буџет да бисте га наставили. Ако треба да зауставите ток, затражите од примарног агента да заустави покретања; прекид обрта сесије сам по себи није команда за отказивање покретања.

## Трошкови

Anthropic-ова [документација о ценама](https://platform.claude.com/docs/en/about-claude/pricing) наплаћује токене модела у Managed Agents-у по тарифи изабраног модела, а време сесије по цени од **0,08 $ за сат активне сесије**. Време се обрачунава док је статус сесије `running`; не рачунају се неактивност, поновно заказивање и прекинуто време. Покретање тока нема посебну накнаду, али се токени нити наплаћују као део сесије. Веб претрага унутар сесије наведена је по цени од 10 $ за 1.000 претрага. Тачан укупан трошак зависи од модела, улазних и излазних токена, алата и трајања сесије; проверите употребу у Console-у уместо да је процењујете на основу ограничења од 1.000 агената.

Практично подешавање почиње са неколико датотека: проверите да ли излаз тока обухвата сваку, прегледајте неуспеле нити, па проширите улаз тек када су политика прегледа и трошак прихватљиви. Управљани токови координишу асинхрони паралелни рад; они не потврђују тачност налаза.

## Највећа промена

Од 9. октобра агент Managed Agents-а може да напише програм тока који сервер извршава кроз више нити агената и фаза. Програмери могу да користе тај пут за ограничено и проверљиво распоређивање посла док главна сесија прати напредак. Функција је и даље у бета верзији, а објављена ограничења не гарантују да ће свако покретање достићи највећу конкурентност или дати тачне налазе.

## Извори и додатно читање

- [Преглед Claude Managed Agents-а](https://platform.claude.com/docs/en/managed-agents/overview) — бета статус, API заглавље, приступ, сесије са стањем, алати и ограничења чувања података.
- [Почетак рада са Claude Managed Agents-ом](https://platform.claude.com/docs/en/managed-agents/quickstart) — подешавање CLI-ја и SDK-а, агента и окружења, креирање сесије и пример тока догађаја.
- [Оркестрација више агената](https://platform.claude.com/docs/en/managed-agents/multiagent-orchestration) — укључивање динамичких токова и избор између токова и подагената.
- [Покретања токова](https://platform.claude.com/docs/en/managed-agents/workflow-runs) — догађаји покретања, тумачење резултата, опоравак, буџети и документована ограничења.
- [Нити сесије](https://platform.claude.com/docs/en/managed-agents/session-threads) — излиставање подређених нити повезаних са покретањем и читање њихове историје догађаја.
- [Датотеке сесије](https://platform.claude.com/docs/en/managed-agents/files) — монтирани улази, путање излаза, излиставање и преузимање датотека сесије.
- [Напомене о издањима Claude Platform-а](https://platform.claude.com/docs/en/release-notes/overview) — ажурирање динамичких токова од 9. октобра 2026. и бета подешавање.
- [Цене Claude Platform-а](https://platform.claude.com/docs/en/about-claude/pricing) — наплата токена и тарифе за време сесије.

## Sources

- [Преглед Claude Managed Agents-а](https://platform.claude.com/docs/en/managed-agents/overview) — Тренутни бета статус, API заглавље, приступ, сесије са стањем и ограничења чувања података.
- [Почетак рада са Claude Managed Agents-ом](https://platform.claude.com/docs/en/managed-agents/quickstart) — Подешавање CLI-ја и SDK-а, агента и окружења, примери сесије и тока догађаја.
- [Оркестрација више агената](https://platform.claude.com/docs/en/managed-agents/multiagent-orchestration) — Омогућавање токова и разлика у односу на подагенте.
- [Покретања токова](https://platform.claude.com/docs/en/managed-agents/workflow-runs) — Механика токова и покретања, догађаји, тумачење стања излаза, опоравак, буџети и ограничења.
- [Напомене о издањима Claude Platform-а](https://platform.claude.com/docs/en/release-notes/overview) — Датирана историја јавне бета верзије и ажурирање динамичких токова од 9. октобра 2026; исправљени канонски URL.
- [Цене Claude Platform-а](https://platform.claude.com/docs/en/about-claude/pricing) — Цене токена и времена сесије у Managed Agents-у.
- [Нити сесије](https://platform.claude.com/docs/en/managed-agents/session-threads) — Излиставање подређених нити повезаних са покретањем и читање њихових историја догађаја.
- [Датотеке сесије](https://platform.claude.com/docs/en/managed-agents/files) — Монтирани улази, путање излаза, излиставање и преузимање датотека сесије.