Vozes e Personas

Vozes nativas em PT-BR disponíveis no Urso Eco. Definição de personas e opções de personalização.

Visão Geral

O Urso Eco oferece vozes nativas em português brasileiro e um sistema flexível de personas que permite personalizar a experiência de conversa por voz. Cada persona combina uma voz, personalidade e base de conhecimento específica.

Vozes Disponíveis

Vozes PT-BR Nativas

Todas as vozes são treinadas com falantes nativos de português brasileiro, capturando a prosódia, entonação e expressividade naturais do idioma.

ID	Nome	Gênero	Descrição	Estilo
`ana`	Ana	Feminino	Voz principal, clara e profissional	Neutro, versátil
`pedro`	Pedro	Masculino	Voz grave e confiante	Formal, autoritativo
`lucia`	Lúcia	Feminino	Voz calorosa e acolhedora	Amigável, empática
`rafael`	Rafael	Masculino	Voz jovem e dinâmica	Casual, energético
`maria`	Maria	Feminino	Voz suave e calma	Tranquilo, didático
`carlos`	Carlos	Masculino	Voz madura e séria	Profissional, jurídico

Características das Vozes

Cada voz possui ajustes configuráveis:

Parâmetro	Tipo	Faixa	Descrição
`speed`	float	0.5 - 2.0	Velocidade da fala (1.0 = normal)
`pitch`	float	-1.0 - 1.0	Tom da voz (0.0 = natural)
`energy`	float	0.5 - 1.5	Energia/volume (1.0 = normal)

{
  "type": "config_update",
  "config": {
    "voice": "lucia",
    "voice_settings": {
      "speed": 1.1,
      "pitch": 0.0,
      "energy": 1.0
    }
  }
}

Personas

Personas Predefinidas

Assistente Geral (`assistente_geral`)

Assistente conversacional versátil para uso geral.

{
  "persona": "assistente_geral",
  "voice": "ana",
  "description": "Assistente inteligente para perguntas gerais e tarefas do dia-a-dia"
}

Comportamento: Responde a perguntas gerais, ajuda com tarefas, fornece informações e mantém conversas naturais. Tom amigável e profissional.

Jurídico (`juridico`)

Especialista em direito brasileiro com acesso à base Jurisia.

{
  "persona": "juridico",
  "voice": "carlos",
  "description": "Especialista jurídico com conhecimento em legislação e jurisprudência brasileira"
}

Comportamento: Responde consultas jurídicas, explica leis e artigos, analisa situações legais. Utiliza linguagem técnica quando apropriado. Sempre ressalta que não substitui aconselhamento jurídico profissional.

Atendimento (`atendimento`)

Agente de atendimento ao cliente.

{
  "persona": "atendimento",
  "voice": "lucia",
  "description": "Agente de atendimento empático e eficiente"
}

Comportamento: Resolução de problemas, suporte técnico, gestão de reclamações. Tom empático e orientado a soluções.

Educacional (`educacional`)

Tutor e professor para fins educacionais.

{
  "persona": "educacional",
  "voice": "maria",
  "description": "Professora paciente que explica conceitos de forma clara e didática"
}

Comportamento: Explicações didáticas, adaptação ao nível do aluno, uso de exemplos e analogias. Tom paciente e encorajador.

Personas Personalizadas

Crie personas personalizadas via API:

import requests

# Criar persona personalizada
response = requests.post(
    "https://api.polarai.com.br/v1/urso-eco/personas",
    headers={"Authorization": "Bearer pk-sua-chave-aqui"},
    json={
        "persona_id": "meu_assistente",
        "name": "Assistente da Empresa XYZ",
        "voice": "ana",
        "system_prompt": """
            Você é o assistente virtual da empresa XYZ, especializada
            em tecnologia. Responda sempre de forma profissional e
            direcionando para os produtos e serviços da empresa quando
            relevante. Principais produtos: Software ERP, CRM e BI.
        """,
        "voice_settings": {
            "speed": 1.0,
            "pitch": 0.0,
            "energy": 1.0
        },
        "knowledge_base": "kb_xyz_empresa",
        "greeting": "Olá! Sou o assistente virtual da XYZ. Como posso ajudar?",
        "language": "pt-BR"
    }
)

persona = response.json()
print(f"Persona criada: {persona['persona_id']}")

Usando uma Persona Personalizada

const ws = new WebSocket("wss://api.polarai.com.br/v1/urso-eco/stream");

ws.onopen = () => {
  ws.send(JSON.stringify({
    type: "auth",
    api_key: "pk-sua-chave-aqui",
    persona: "meu_assistente"
  }));
};

Gerenciamento de Personas

Listar Personas

curl https://api.polarai.com.br/v1/urso-eco/personas \
  -H "Authorization: Bearer pk-sua-chave-aqui"

Atualizar Persona

curl -X PATCH https://api.polarai.com.br/v1/urso-eco/personas/meu_assistente \
  -H "Authorization: Bearer pk-sua-chave-aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "voice": "pedro",
    "system_prompt": "Prompt atualizado..."
  }'

Deletar Persona

curl -X DELETE https://api.polarai.com.br/v1/urso-eco/personas/meu_assistente \
  -H "Authorization: Bearer pk-sua-chave-aqui"

Opções de Personalização

Opção	Descrição	Personas Predefinidas	Personas Personalizadas
Escolha de voz	Selecionar entre vozes disponíveis	Sim	Sim
Ajuste de velocidade	Modificar velocidade da fala	Sim	Sim
System prompt	Definir comportamento	Não	Sim
Knowledge base	Base de conhecimento	Não	Sim
Saudação	Mensagem de boas-vindas	Não	Sim
Idioma	Idioma da conversa	Sim	Sim

Limites

Máximo de 50 personas personalizadas por conta
Tamanho máximo do system prompt: 10.000 caracteres
Tamanho máximo da saudação: 500 caracteres

On this page