Nastavení s programovacím agentem

Max PrilutskiyCEO a spoluzakladatel4 min čtení

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 #

text
Set up Lingo.dev localization in this project. Run npx @lingo.dev/cli@latest agent-guide setup and follow it.

Agent:

  1. 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.
  2. 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í).
  3. Požádá vás o přihlášení. Až vás vyzve, spusťte npx @lingo.dev/cli@latest login ve vlastním terminálu; klíč API nikdy nevkládejte do konverzace.
  4. Spustí lingo init a lingo 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.
  5. Ukáže vám plán a lingo push --estimate a po vašem schválení provede překlad.
  6. Zaregistruje nové jazyky v aplikaci a nabídne připojení GitHub App.

Připojení GitHub App #

text
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:

markdown
<!-- 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.md chybí, 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 soubor AGENTS.md, který už blok obsahuje (@AGENTS.md). Soubor CLAUDE.md se 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 #

bash
lingo agent setup

Ověří, 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-runUkáže, co by se změnilo, ale nic nezapíše.
--statusUkáže, co je nastaveno pro rozpoznané agenty. Ignoruje --client.
-y, --yesZapíš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 #

bash
lingo agent-guide           # the agent guide and the list of guides
lingo agent-guide setup     # one guide

Bez 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).