← Vytvářejte agenty na Cloudflare / agents

Harnesses

Harness je smyčka, díky které se agent chová jako agent, a ne jako jediné volání modelu.

Zodpovídá za práci kolem modelu v jednotlivých tazích: sestavení promptu, načtení paměti, výběr nástrojů, zpracování výsledků nástrojů, streamování odpovědí, ukládání zpráv a rozhodování, zda má agent pokračovat, nebo skončit.

Tuto smyčku si můžete sestavit sami nad runtime Agents SDK, nebo použijte harness s pevně danou strukturou, například Projekt Think.

Harnessy fungují nad runtime Agents SDK:

• Runtime dává agentovi trvalou infrastrukturu: Agent třída, stav, relace, směrování, WebSockets, plánování, fibery, a observabilita.
• Harness dává agentovi chování: volání modelu, sestavování promptů, výběr nástrojů, zpracování streamu, strategii paměti a hooky životního cyklu.

Runtime odpovídá na otázku „kde agent žije a jak zůstává trvalý?“. Harness odpovídá na otázku „co agent dělá v každém kole?“

Použijte harness typu build-your-own, pokud potřebujete plnou kontrolu nad voláním modelu, formátem zpráv, smyčkou nástrojů nebo protokolem UI. Tento přístup je správný, pokud chcete skládat nízkoúrovňová API přímo z Agents SDK.

Použijte Project Think, pokud chcete harness s pevně danou strukturou pro chatovací agenty a výchozím nastavením pro paměť, nástroje pracovního prostoru, streamování, hooky životního cyklu, RPC podřízeného agenta a trvalé obnovení chatu.

Harness obvykle zajišťuje:

• Sestavení promptu : systémové prompty, paměť, načtený kontext a pokyny pro jednotlivá kola.
• Provádění modelu : volání Workers AI, OpenAI, Anthropic, Gemini nebo jiného poskytovatele.
• Orchestrace nástrojů : serverové nástroje, klientské nástroje, nástroje MCP, schvalovací postupy a pokračování po výsledcích nástrojů.
• Perzistence zpráv : jak se ukládají a přehrávají zprávy uživatele, asistenta a nástrojů.
• Streamování a obnovení : jak se odpovědi streamují klientům a jak pokračují po odpojení nebo vyřazení Durable Object z paměti.
• Body rozšíření : hooky, které se spouštějí před koly, kroky, voláními nástrojů a událostmi obnovení i po nich.