← Vytvářejte agenty na Cloudflare / agents / tools
Code Mode
Code Mode je vzor použití nástrojů, ve kterém model píše kód místo toho, aby si o každou operaci žádal zvlášť. Model dostane jeden nástroj pro spouštění kódu. Jeho kód se stává kompaktním plánem, který volá nástroje, zpracovává výsledky a vrací informace potřebné pro odpověď.
Code Mode zpřístupňuje nakonfigurované nástroje jako typované metody. Modely tyto metody používají k vyjádření vícekrokové práce pomocí známých programovacích konstrukcí. V závislosti na integraci lze definice nástrojů poskytnout předem, nebo je zjišťovat podle potřeby.
Kód jako plán
Při přímém použití nástrojů model vybere jeden nástroj, obdrží jeho výsledek a poté rozhodne, co dělat dál. Každá operace si může vyžádat další cyklus požadavku a odpovědi přes model.
Code Mode přesouvá tuto mezilogiku do spustitelného kódu. Jeden plán může:
- Sestavte několik závislých volání nástrojů.
- Iterujte přes kolekce výsledků.
- Filtruje a transformuje vrácená data.
- Větvěte na základě dřívějších výsledků.
- Upravte konečnou vrácenou hodnotu.
Tento přístup drží řídicí tok a zpracování dat pohromadě. Hodí se v situacích, kdy model musí před vytvořením odpovědi koordinovat několik operací.
Postupné zjišťování nástrojů
Rozsáhlé katalogy nástrojů mohou zabrat značnou část kontextu modelu, pokud se všechny definice načtou předem. Runtime Code Mode založený na konektorech proto podporuje postupné objevování pomocí codemode.search() a codemode.describe().
Search najde relevantní konektory, metody a uložené fragmenty kódu. Describe vrátí podrobné informace o typu pro vybraný cíl. Tyto výsledky vstupují do spouštěného kódu, takže model může načíst pouze definice, které potřebuje, místo aby s každým požadavkem dostával celý katalog.
Zvolte mezi Code Mode a přímými voláními nástrojů
Při přímých voláních nástrojů se každý výsledek vrátí modelu ještě předtím, než zvolí další operaci. Mezilehlá data zabírají kontext, i když model pro konečnou odpověď potřebuje jen jejich malou část.
Code Mode udržuje tuto práci uvnitř jednoho spuštění v sandboxu. Vygenerovaný kód může předávat výsledky mezi nástroji, filtrovat mezivýsledky a vracet jen konečnou hodnotu, kterou model potřebuje. Díky tomu jsou úlohy zahrnující více nástrojů efektivnější a snáz se zobecňují nebo opakují.
Použijte přímá volání nástrojů pro jednoduché úlohy s malou, pevnou sadou nástrojů. Použijte Code Mode, pokud úloha vyžaduje skládání, závislá volání, postupné zjišťování, opakovaně použitelnou logiku nebo řízení toku:
| Vzor | Nejvhodnější pro |
|---|---|
| Přímá volání nástrojů | Jednoduché úlohy s malou, známou sadou nástrojů |
| Code Mode | Složená nebo závislá volání, rozsáhlé katalogy nástrojů, smyčky, větvení, filtrování, tvarování výsledků nebo opakovaně použitelná logika |
Zvolte integraci
Code Mode poskytuje rozhraní pro runtime agentů, frameworky AI, prohlížeče a systémy Model Context Protocol (MCP).