What are local edits in Nano Banana?

Local edits are precise modifications to a model’s behavior for a specific scope. In Nano Banana, you define triggers and targets so the edit applies only when relevant, minimizing regressions elsewhere.

How do I choose between rewrite, bias, and constraint edits?

Use rewrite for factual corrections or templated outputs, bias for subtle preference shifts, and constraint for hard rules like mandatory disclaimers. Start lighter (rewrite or bias) and escalate only if tests fail.

How can I prevent local edits from affecting unrelated queries?

Tighten your trigger scope with negatives, increase the semantic radius, or switch to a classifier trigger. Always include counterfactual tests to ensure stability.

Can I roll back a local edit in Nano Banana?

Yes. Nano Banana supports versioning and rollback. Validate each edit, use canary rollout, and keep a rollback window so you can revert instantly if metrics degrade.

How do I test local edits effectively?

Create positive prompts, counterfactual prompts, and stress tests, then validate before activation. Measure pass rate, counterfactual drift, and UX metrics like CSAT to ensure the edit helps without collateral damage.

Ako robiť lokálne úpravy s Nano Banana: Praktický sprievodca

Ak ste si niekedy priali, aby ste mohli doladiť len jednu časť správania modelu – bez preškolenia, narušenia všetkého ostatného alebo čakania hodiny – lokálne úpravy sú vaša nová superschopnosť. V tomto sprievodcovi si krok za krokom prejdeme, ako robiť lokálne úpravy s Nano Banana, s praktickými príkladmi a nástrahami, ktorým sa treba vyhnúť.

Odvážne tvrdenie: Lokálne úpravy vám umožňujú chirurgicky opraviť jedno správanie modelu a zároveň ponechať zvyšok nedotknutý. Predstavte si to ako rýchlu opravu, nie ako prestavbu.

Tento tutoriál sa riadi štýlom Praktické a orientované na riešenia. Budeme sa držať praktických postupov, ukážeme vám vzory podobné kódu a zameriame sa na výsledky, ktoré môžete rýchlo overiť.

Čo sú lokálne úpravy (a prečo používať Nano Banana)?

Lokálne úpravy sú presné modifikácie odpovedí modelu pre špecifické vstupy alebo koncepty, bez ovplyvnenia nesúvisiacich výstupov.

Nano Banana (NB) je nenáročný nástroj na úpravu pre LLM a hlavy klasifikátorov, ktorý zdôrazňuje:

Rýchlosť: Úpravy v sekundách, nie v hodinách

Izoláciu: Minimalizujte regresie inde

Reverzibilitu: Čisto vráťte alebo verzujte úpravy

Auditovateľnosť: Sledujte presne, čo sa zmenilo a prečo

Typické prípady použitia:

Opravte model, ktorý halucinuje cenu produktu, vynútením opraveného faktu

Znížte alebo odstráňte zaujatú asociáciu pre konkrétnu entitu

Pridajte nové pravidlo pre citlivú doménu (napr. lekárske upozornenia) bez preškolenia

Opravte vzor odpovede „známy ako zlý“ identifikovaný v red-teamingu

Predtým, ako začnete: Koncepty, ktoré budete používať

Rozsah úprav: Spúšťacie podmienky definujúce, kedy sa úprava použije (vzory, vloženia alebo brány klasifikátora).

Cieľ úpravy: Správanie, ktoré chcete (nová preferencia tokenu, obmedzenie alebo šablóna prepísania).

Sila úpravy: Ako silno úprava prebíja základný model (mäkké vs. tvrdé obmedzenia).

Bezpečnostné testy: Kontrafaktuálne výzvy, ktoré by sa nemali zmeniť – nevyhnutnosť, aby sa predišlo regresiám.

Vrátenie/verzionovanie: Schopnosť vrátiť späť alebo porovnať varianty úprav.

Rýchly štart: 10-minútová cesta

Tu je najrýchlejší spôsob, ako dosiahnuť, aby lokálna úprava fungovala v Nano Banana. Príklady používajú pseudo-API, ktoré zrkadlia bežné vzory NB, aby ste sa mohli prispôsobiť svojmu prostrediu.

from nano_banana import NBEditor, Trigger, Target, Tests
# 1) Inicializujte editor s vaším modelom
nb = NBEditor(model="your-llm-13b", storage="./nb_store")
# 2) Definujte spúšťač (rozsah úprav)
trigger = Trigger(
type="semantic", # semantic | pattern | classifier
positive=["Acme Pro 5 price"], # frázy na ukotvenie konceptu
negative=["Acme Pro 4", "Acme Lite"],
radius=0.85 # prah podobnosti pre aktiváciu
)
# 3) Definujte cieľové správanie
target = Target(
mode="rewrite", # rewrite | bias | constraint
template="The current price of Acme Pro 5 is $699.",
strength=0.65 # 0..1; vyššia = silnejšie prebitie
)
# 4) Pridajte bezpečnostné testy
tests = Tests(
positives=[
("What's the price of Acme Pro 5?", "699"),
],
counterfactuals=[
("What's the price of Acme Pro 4?", "do not say 699"),
("Compare Acme Pro 5 to Acme Lite", "avoid price rewrite unless directly asked"),
]
)
# 5) Použite úpravu a overte
edit_id = nb.apply(trigger, target, tests)
report = nb.validate(edit_id)
print(report.summary)
# 6) Aktivujte po prechode bránami
if report.pass_rate > 0.95 and report.cf_drift < 0.02:
nb.activate(edit_id)
else:
nb.rollback(edit_id)

Výber správneho typu úpravy

Prepísanie: Najlepšie pre faktické opravy alebo šablónové posuny. Príklad: oprava špecifikácie produktu.

Posun: Upravte pravdepodobnosti na úrovni tokenov bez šablónovania. Príklad: odrádzajte od nebezpečných slovies v úzkom kontexte.

Obmedzenie: Vynúťte tvrdé pravidlá (napr. musí obsahovať upozornenie). Používajte striedmo, aby ste sa vyhli neprirodzenému frázovaniu.

Kedy použiť sémantické vs. vzorové spúšťače

Sémantické spúšťače: Odolné voči parafrázam. Skvelé pre koncepty ako „cena Acme Pro 5“.

Vzorové spúšťače: Zhody regulárnych výrazov alebo kľúčových slov. Dobré pre prísne formáty (napr. kódy SKU).

Klasifikačné spúšťače: Vytrénujte malú bránu na pozitívnych/negatívnych príkladoch pre presnosť v zložitých doménach.

Budovanie spoľahlivých spúšťačov

Začnite s 5 – 10 pozitívnymi počiatočnými frázami a 5 – 10 negatívnymi.

Merajte drift aktivácie: ako často sa spúšťač spustí na nesúvisiacich vstupoch.

Nalaďte rádius tak, aby sa vaše pozitíva konzistentne spúšťali, zatiaľ čo kontrafaktuály nie. Zamerajte sa na <2 % falošných aktivácií.

probe = nb.dry_run(trigger, samples=[
"How much is Acme Pro 5?",
"Is Acme Pro 4 cheaper?",
"Acme Lite warranty details",
])
probe.metrics

Vytváranie cieľov bez vedľajších škôd

Preferujte stručné šablóny: jedna veta často prekoná tri.

Udržujte silu najskôr miernu (0,4 – 0,7); zvyšujte len ak testy zlyhajú.

Pre úpravy súladu použite podmienenú šablónu:

target = Target(
mode="rewrite",
template="If the user asks about pricing, respond: 'The current price of Acme Pro 5 is $699.' Otherwise, proceed normally.",
strength=0.55
)

Testovanie: Vaša bezpečnostná sieť

Navrhnite testy, akoby vám za to vaša budúca ja poďakovala.

Pozitíva: Priame zásahy a parafrázy („cena“, „náklady“, „koľko“).

Kontrafaktuály: Podobné entity, rôzne modely, porovnania.

Záťažové testy: Dlhé výzvy, nepriateľské frázovanie, viacjazyčné varianty.

suite = nb.autogenerate_tests(
positives_topic="Acme Pro 5 pricing",
counterfactuals_topics=["Acme Pro 4 pricing", "Acme Lite features"],
paraphrase_count=25)
report = nb.validate(edit_id, suite)

Verzionovanie a vrátenie späť ako profesionál

Používajte sémantické verzionovanie pre úpravy: [email protected].

Vždy overte pred aktiváciou; nikdy neaktivujte za horúca na produkčnej prevádzke.

Udržujte okno vrátenia späť a kanársky režim (napr. 1 % prevádzky) na detekciu regresií.

nb.activate(edit_id, rollout="canary:1%")
nb.monitor(edit_id, metrics=["ctr", "csat", "drift"]) # obchodné + modelové metriky

Scenáre z reálneho sveta, s ktorými sa stretnete

Fakty o produkte sa časom menia

Spúšťač: sémantický na entite produktu

Cieľ: prepísať s dynamickou premennou

Integrácia: stiahnite si živú hodnotu zo svojho zdroja pravdy o cenách

def dynamic_price:
return fetch_price("Acme Pro 5")
target = Target(mode="rewrite", template=lambda: f"The current price of Acme Pro 5 is ${dynamic_price}.", strength=0.6)

Pridajte bezpečnostné upozornenia bez nadmerného dohľadu

Spúšťač: klasifikátor pre lekársky zámer o používaní mimo označenia

Cieľ: obmedzenie + krátke upozornenie

Tip: Zahrňte kontrafaktuály pre neškodné zdravotné otázky, aby ste sa vyhli nadmernému spúšťaniu

Znížte zaujatú asociáciu

Spúšťač: sémantický na citlivej entite

Cieľ: režim posunu na zníženie pravdepodobnosti škodlivých deskriptorov

Testy: sondy spravodlivosti naprieč demografickými skupinami

Meranie úspechu

Sledujte výsledky modelu aj produktu:

Presnosť úpravy: Ako často sa úprava spustí, keď by mala

Kontrafaktuálna stabilita: Miera driftu pri takmer zásahoch

Spokojnosť používateľov: CSAT alebo miera palca hore na upravené odpovede

Režijná latencia: Cieľ <10 ms dodatočný čas na požiadavku

Obchodné KPI: Znížené eskalácie, vyššia miera riešenia, menej vlajok súladu

Riešenie problémov s lokálnymi úpravami v Nano Banana

Zdá sa, že úprava sa nepoužije

Znížte sémantický rádius alebo pridajte viac pozitívnych semien

Mierne zvýšte silu (o 0,05 – 0,1)

Potvrďte, že runtime načítava aktívnu sadu úprav

Príliš veľa falošných poplachov

Pridajte negatíva a zvýšte rádius

Preveďte zo sémantického na klasifikačný spúšťač pre presnosť

Odpovede znejú nútene

Skráťte šablónu; prepnite do režimu posunu pre jemnejší dotyk

Znížte silu; pridajte podmienenú klauzulu

Pokles výkonu

Dávkujte výpočet spúšťača; ukladajte do vyrovnávacej pamäte dotazy na vloženie

Odstráňte neaktívne úpravy; vyhnite sa prekrývajúcim sa spúšťačom

Správa a audit

Udržujte záznam zmien s: autorom, zámerom, spúšťačmi, cieľmi, testami a výsledkami.

Vyžadujte kontrolu pre úpravy s vysokým dopadom (súlad, bezpečnosť, financie).

Snímka exemplárov pred/po pre auditovateľnosť.

Pokročilé vzory

Hierarchické spúšťače: Široký klasifikátor bráni špecifickému sémantickému spúšťaču pre menej falošných poplachov.

Časovo ohraničené úpravy: Automaticky ukončite platnosť úprav po dátume; skvelé pre propagačné akcie.

Šablóny pre viac entít: Používajte premenné: {{product}}, {{price}}, {{region}} s prekladačom.

A/B varianty úprav: Súťažte [email protected] vs [email protected], aby ste zistili, ktorý prináša lepšiu UX.

Integrácia do vášho zásobníka

Ukladajte úpravy do verzionovaného registra a načítajte ich pri spustení modelového servera.

Vystavte malé administratívne používateľské rozhranie na prepínanie, vrátenie späť a kontrolu dopadu.

Streamujte udalosti, keď sa spustí spúšťač pre pozorovateľnosť.

pozorovateľnosť:
emit_trigger_events: true
payload: [user_id, prompt_hash, edit_id, activation_score]

Mimochodom: Zrýchlenie tvorby pomocou Sider.AI

Stojí za zmienku: ak udržiavate veľa malých úprav, tvorba testov a parafráz môže byť únavná. Nástroje ako Sider.AI vám môžu pomôcť generovať parafrázované výzvy, organizovať kontrafaktuálne sady a dokumentovať odôvodnenia úprav. Nenahrádza to vaše overenie – len urýchľuje nudné časti, aby ste sa mohli sústrediť na brány kvality.

Zhrnutie: Kontrolný zoznam, ktorý môžete znova použiť

Definujte správanie, ktoré chcete; udržujte ho úzko zamerané

Vyberte typ spúšťača: sémantický, vzorový alebo klasifikačný

Začnite s miernou silou a krátkou šablónou

Vytvorte pozitíva, kontrafaktuály a záťažové testy

Overte, kanársky, monitorujte a až potom zavádzajte

Verzionujte každú zmenu a majte vrátenie späť po ruke

Ďalšie kroky

Implementujte svoju prvú sémantickú spúšťaciu úpravu prepísania

Pridajte bezpečnostnú úpravu spúšťača klasifikátora s upozorneniami

Automatizujte generovanie parafráz a regresné testovanie

Merajte drift týždenne a odstraňujte zastarané úpravy

Ak budete postupovať podľa tohto pracovného postupu, získate jasné a spoľahlivé lokálne úpravy s Nano Banana – rýchle na odoslanie, jednoduché na správu a bezpečné na vrátenie späť.

FAQ

Q1:Čo sú lokálne úpravy v Nano Banana? Lokálne úpravy sú presné modifikácie správania modelu pre špecifický rozsah. V Nano Banana definujete spúšťače a ciele, aby sa úprava použila len vtedy, keď je to relevantné, čím sa minimalizujú regresie inde.

Q2:Ako si vyberiem medzi úpravami prepísania, posunu a obmedzenia? Použite prepísanie pre faktické opravy alebo šablónové výstupy, posun pre jemné posuny preferencií a obmedzenie pre tvrdé pravidlá, ako sú povinné upozornenia. Začnite jemnejšie (prepísanie alebo posun) a eskalujte len ak testy zlyhajú.

Q3:Ako môžem zabrániť tomu, aby lokálne úpravy ovplyvnili nesúvisiace dotazy? Sprísnite rozsah spúšťača pomocou negatív, zvýšte sémantický rádius alebo prepnite na spúšťač klasifikátora. Vždy zahrňte kontrafaktuálne testy, aby ste zabezpečili stabilitu.

Q4:Môžem vrátiť späť lokálnu úpravu v Nano Banana? Áno. Nano Banana podporuje verzionovanie a vrátenie späť. Overte každú úpravu, použite kanárske zavádzanie a udržujte okno vrátenia späť, aby ste sa mohli okamžite vrátiť, ak sa metriky zhoršia.

Q5:Ako môžem efektívne testovať lokálne úpravy? Vytvorte pozitívne výzvy, kontrafaktuálne výzvy a záťažové testy, potom overte pred aktiváciou. Merajte mieru úspešnosti, kontrafaktuálny drift a metriky UX, ako je CSAT, aby ste zabezpečili, že úprava pomáha bez vedľajších škôd.