Nastavení s programovacím agentem
CLI obsahuje příručky pro programovací agenty, jako jsou Claude Code, Codex a Cursor. Zadejte svému agentovi jeden z níže uvedených promptů. Spustí lingo agent-guide, přečte si příručku k danému úkolu a pomocí CLI provede potřebné úpravy ve vašem repozitáři. Úkony na úrovni účtu, například správu glosáře pro engine nebo připojení GitHub App, provádí přes Lingo.dev MCP server.
Příručky se dodávají s CLI, takže si agent vždy přečte příručku odpovídající verzi, kterou používá. Než cokoli přeloží, ukáže vám plán a odhad a počká na vaše schválení.
Prompty #
Vložte prompt do agenta spuštěného v kořenovém adresáři projektu.
Nastavení Lingo.dev od začátku #
Set up Lingo.dev localization in this project. Run npx @lingo.dev/cli@latest agent-guide setup and follow it.Agent:
- Ověří, zda má k dispozici nástroje Lingo.dev MCP. Pokud ne, přidá server a požádá vás o restart a opětovné vložení promptu. Agent v cloudu nebo CI tento krok i přihlášení v prohlížeči přeskočí; viz Relace bez lidské obsluhy.
- Zjistí, jaké technologie projekt používá, najde všechny zdrojové soubory, které aplikace načítá, a postupuje podle odpovídající příručky (Rails, iOS, Android, Markdoc, e-maily, knihovna i18n nebo web s dokumentací).
- Požádá vás o přihlášení. Až vás vyzve, spusťte
npx @lingo.dev/cli@latest loginve vlastním terminálu; klíč API nikdy nevkládejte do konverzace. - Spustí
lingo initalingo link. Pokud už projekt obsahuje překlady, zkontroluje, zda v nich nejsou poškozené zástupné symboly, nepřeložený text nebo nejednotná terminologie. Opraví jen to, co schválíte. - Ukáže vám plán a
lingo push --estimatea po vašem schválení provede překlad. - Zaregistruje nové jazyky v aplikaci a nabídne připojení GitHub App.
Připojení GitHub App #
Connect the Lingo.dev GitHub App to this repository. Run npx @lingo.dev/cli@latest agent-guide github and follow it.Agent nejprve nastaví projekt, pokud ještě není nastavený. Ověří, zda má GitHub App přístup k repozitáři, a poskytne vám odkazy k vyřešení případných problémů. Nechá vás vybrat, zda má aplikace překládat po sloučení změn, nebo v pull requestech. Pull request s konfigurací otevře až po vašem souhlasu.
Blok AGENTS.md #
lingo init a lingo agent setup zapíší krátký blok do AGENTS.md v kořenovém adresáři projektu, aby agent v každé další relaci věděl, že si má před prací na lokalizaci přečíst příručky:
<!-- lingo:begin -->
## Lingo.dev localization
This project is localized with Lingo.dev. The config is `.lingo/config.json` next to this file. Lingo.dev commands and workflows change between versions, so do not rely on what you remember about them.
Before any localization task (translating content, adding a locale, connecting GitHub, changing the glossary or tone of voice), run `npx @lingo.dev/cli agent-guide` from this directory and follow the guide it names. The guides ship with the CLI and describe the version you run.
This block is written by `lingo init` and `lingo agent setup`. Text between the markers is replaced on the next run; keep your own notes outside them.
<!-- lingo:end -->- Pokud
AGENTS.mdchybí, vytvoří se. Text mimo značky zůstane zachován a při dalším spuštění se nahradí pouze text mezi nimi. - Blok se přidá i do existujícího souboru
CLAUDE.md, pokud neimportuje souborAGENTS.md, který už blok obsahuje (@AGENTS.md). SouborCLAUDE.mdse nikdy nevytváří. - Pokud soubor nelze přečíst, odkazuje mimo projekt nebo obsahuje nespárované značky, zůstane beze změny a zobrazí se varování. Opravte soubor a znovu spusťte
lingo agent setup. Pokud příkaz vašeho agenta nerozpozná, přidejte--client <name>. - Chcete-li blok vynechat, spusťte
lingo init --no-agents-md.
Když agent spustí příkaz Lingo.dev v projektu, jehož AGENTS.md nebo CLAUDE.md neobsahuje blok, CLI vypíše na stderr jeden řádek s pokynem ke spuštění lingo agent setup -y. Lidem ani CI se tato zpráva nezobrazuje.
lingo agent setup #
lingo agent setupOvěří, zda programovací agenti na tomto počítači (Claude Code, Codex a Cursor i agent, ve kterém příkaz právě běží) mají Lingo.dev MCP server. U každého, který jej nemá, uvede konfigurační soubor, který je třeba upravit. Konfigurace agentů nikdy neupravuje; server přidejte podle postupu v části Nastavení MCP. Při spuštění v projektu po vašem souhlasu také zapíše blok AGENTS.md.
| Přepínač | Účinek |
|---|---|
--client <name> | Zkontroluje pouze tohoto agenta, i když nebyl rozpoznán: claude-code, codex nebo cursor. Lze použít opakovaně. |
--dry-run | Ukáže, co by se změnilo, ale nic nezapíše. |
--status | Ukáže, co je nastaveno pro rozpoznané agenty. Ignoruje --client. |
-y, --yes | Zapíše blok bez dotazu. |
Pokud není k dispozici žádný agent ke kontrole, příkaz bez --status skončí chybou a nic nezapíše. Agenta proto určete pomocí --client.
lingo agent-guide #
lingo agent-guide # the agent guide and the list of guides
lingo agent-guide setup # one guideBez názvu vypíše příručku, kterou každý agent začíná (CLI nebo MCP, přihlášení, nedokončené úvodní nastavení), a seznam příruček. S názvem vypíše danou příručku. Při zadání neznámého názvu skončí s kódem 1 a vypíše příručky dostupné v této verzi. Uživatelé @lingo.dev/react mají vlastní příručky v lingo guide.
Relace bez lidské obsluhy #
V relaci v cloudu nebo CI nastavte LINGO_API_KEY, aby se agent nemusel přihlašovat. Takový agent provede část úkolu využívající CLI a MCP server nenastavuje. V závěrečné zprávě uvede, co ještě zbývá udělat a vyžaduje přístup k účtu. Tyto úkoly můžete dokončit ve webové aplikaci nebo pomocí agenta, který má MCP server.
Pokud je překlad odmítnut z fakturačních důvodů, CLI skončí s kódem 9, když je nutný zásah člověka (došly kredity, byl dosažen limit pro engine nebo v plánu chybí potřebná funkce), a s kódem 75, pokud byl vyčerpán denní limit tokenů. Vypíše důvod a odkaz na stránku fakturace. Příručky agentům ukládají, aby při kterémkoli z těchto kódů práci zastavili.
Hlášení od agentů #
Příručky žádají agenty, aby při selhání kroku a po dokončení úkolu odeslali do Lingo.dev krátké hlášení pomocí lingo agent report, abychom mohli příručky vylepšovat. Hlášení obsahuje příručku a krok, shrnutí v jedné nebo dvou větách, návrh agenta, jeho název a propojenou organizaci a engine. CLI ze shrnutí a návrhu odstraní přihlašovací údaje a tajné hodnoty a každou z těchto položek zkrátí na 500 znaků. Příručky agentům ukládají, aby do žádného pole nevkládali kód, obsah souborů ani tajné údaje. Hlášení nikdy nezpůsobí selhání úkolu a nic se neodesílá, pokud není nikdo přihlášen nebo je telemetrie vypnutá (LINGO_TELEMETRY_DISABLED=1, DO_NOT_TRACK=1 nebo OTEL_SDK_DISABLED=true).