CASO DE USO EM PRODUÇÃO

API de IA para chatbots multilíngues

Um produto de viagens aceita inglês, japonês, espanhol e chinês. O sistema detecta idioma e região, carrega o glossário e as políticas locais e pede uma resposta sem traduzir os nomes de produto protegidos.

Conversa multilíngue que preserva termos locais
API de IA para chatbots multilíngues

Implementação para produção

API, modelo principal e configuração alternativa

Escolha para produçãoRecomendaçãoPor quê
APIPOST /v1/chat/completionsRequisição do servidor compatível com OpenAI
Modelo principalgemini-2.5-flashGemini 2.5 Flash é a primeira opção para chat multilíngue que exige baixa latência.
Modelo alternativogpt-5.6-terraUse Terra só nos idiomas que passarem pela mesma revisão de falantes nativos. Encaminhe ao Sol ou a uma pessoa os casos que falhem com políticas complexas ou idiomas misturados.
Modelo para tarefas mais difíceisgpt-5.6-solUse só se a rota principal não atingir o limite de qualidade ou complexidade
Formato esperadoTexto ou alterações conforme a tarefaUma resposta adequada ao idioma e à região, com termos protegidos intactos e sem políticas de outra região.
01
Exemplo

Chatbots multilíngues em produção

Um produto de viagens aceita inglês, japonês, espanhol e chinês. O sistema detecta idioma e região, carrega o glossário e as políticas locais e pede uma resposta sem traduzir os nomes de produto protegidos.

A qualidade é avaliada por idioma. Uma boa média não basta para lançar um idioma. Primeiro, revisores nativos devem aprovar intenção, termos, tom e recusas daquela região.

02
Arquitetura

Como funciona o processo de chatbots multilíngues

  • Detecte idioma e região separadamente.
  • Carregue o glossário local e as políticas aprovadas.
  • Gere diretamente no idioma de destino.
  • Confira termos protegidos, números e redação das políticas.
  • Encaminhe a uma pessoa idiomas não aceitos ou com baixa confiança.
03
Requisição de API

Chame gemini-2.5-flash pela LLMFly AI

Envie a requisição pelo servidor. Troque o conteúdo e os esquemas de exemplo pelos dados e ferramentas do aplicativo.

request.example
curl https://app.llmfly.ai/v1/chat/completions \
  -H "Authorization: Bearer $LLMFLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-flash",
    "messages": [
      {"role": "system", "content": "Reply in the detected locale. Preserve GLOSSARY terms exactly. Use only the supplied locale policy and do not translate protected product names."},
      {"role": "user", "content": "Explain the cancellation window in the customer's language using the locale policy."}
    ]
  }'
04
Escolha do modelo

Por que gemini-2.5-flash é o modelo principal

Gemini 2.5 Flash é a primeira opção para chat multilíngue que exige baixa latência.

Use Terra só nos idiomas que passarem pela mesma revisão de falantes nativos. Encaminhe ao Sol ou a uma pessoa os casos que falhem com políticas complexas ou idiomas misturados.

05
Aceitação

Testes de aceitação de chatbots multilíngues

MétricaCondição de aprovação
Preservar a intençãoA ação e as restrições se mantêm em todos os idiomas aceitos
Precisão dos termosTermos protegidos de produto, jurídicos e técnicos seguem o glossário local
Aprovação de falantes nativosUm revisor nativo aprova sentido, tom e fluidez sem reescrita importante
Latência e custo por idiomaCada idioma lançado cumpre seu orçamento de tempo de resposta e custo por conversa
06
Tratamento de falhas

Falhas a tratar antes de publicar

  • Supor que o inglês prevê todos os idiomas
  • Traduzir os testes automaticamente
  • Ignorar as políticas locais
  • Esconder idiomas fracos na média
07
Saída

Saída e histórico de execução

Uma resposta adequada ao idioma e à região, com termos protegidos intactos e sem políticas de outra região.

Registre ID do modelo e da requisição, tokens, novas tentativas, validação e decisão final em cada execução de produção.

Dúvidas frequentes

Posso usar prompts traduzidos do inglês?

Use exemplos nativos: intenção, tom, termos e políticas mudam conforme a região.

Um modelo deve atender todos os idiomas?

Só se passar nos testes de cada idioma. Encaminhar a modelos testados separadamente pode ser mais seguro.

Como testar mensagens com idiomas misturados?

Use mensagens reais com idiomas misturados e confira a preservação da intenção e dos termos necessários.

Teste esta configuração com seus dados

Compare principal e alternativo com as mesmas requisições, ferramentas e regras de validação.

Comparar modelos