O CopyDoc oferece duas formas de usar o Gemini:
- Gemini API, para traduzir e importar automaticamente dentro do plugin.
- Gemini Prompt, para um fluxo de trabalho manual de copiar e colar usando o app do Gemini.
Usar a API do Gemini
- Clique no botão Localize Frames no CopyDoc.
- Escolha Gemini API.
- Cole sua chave de API do Google AI Studio.
- Escolha o modelo do Gemini que o CopyDoc deve usar.
- Selecione os frames do Figma e os idiomas de destino que você quer traduzir.
- Ative Use Markdown se precisar preservar negrito, itálico e links dentro do texto durante a tradução.
- Clique em Translate & Import.
O CopyDoc envia o texto dos frames selecionados ao Gemini para tradução e depois importa automaticamente os resultados traduzidos de volta para o Figma como cópias localizadas dos frames.
Sua chave de API do Gemini fica armazenada no seu dispositivo, por usuário do Figma, e não é salva no próprio arquivo do Figma.
Usar o prompt do Gemini
- Escolha Gemini Prompt nas opções de localização.
- Selecione os frames do Figma e os idiomas que você quer traduzir.
- Clique em Generate Prompt.
- Clique em Copy Prompt to Clipboard.
- Execute o prompt no Gemini e confira se a resposta contém somente o CSV puro.
- Cole a resposta em CSV de volta no CopyDoc.
- Clique em Translate Figma Frames para importar o conteúdo traduzido para o Figma.
No fluxo com prompt manual, você mesmo escolhe o modelo do Gemini dentro do Gemini. O CopyDoc valida a estrutura do CSV antes de importar os frames traduzidos para o Figma.
O prompt gerado também pede ao Gemini que preserve a formatação Markdown compatível dentro do texto e mantenha inalterados os marcadores Markdown, as URLs e os placeholders, para que o conteúdo traduzido possa ser importado corretamente de volta para o Figma.
Não remova nem renomeie as colunas id, frame_id, layer_name ou figma_text na resposta em CSV. O CopyDoc usa essas colunas para relacionar as linhas traduzidas às camadas corretas do Figma.