O que são Valves e UserValves?

SinapseTech 23
Viewed 2

Vejo 'Valves' nos exemplos de tools. O que é isso?

valves configuracao ferramentas cortex
1 Answers

Valves são o mecanismo de configuração de Tools e Functions. Dois níveis:

Nível Classe Configurado por Onde
Admin Valves Administradores Admin → Ferramenta → ⚙️
Usuário UserValves Cada usuário Interface de chat

Exemplo prático:

class Valves(BaseModel):
    crm_url: str = Field(default="", description="URL do CRM")
    api_key: str = Field(default="", description="Token admin")
    timeout: int = Field(default=10)

class UserValves(BaseModel):
    idioma: str = Field(default="pt_br")
    detalhamento: str = Field(default="medio")

Boas práticas:

  • ✅ Use Field(default=..., description=...) sempre — description aparece na UI
  • ✅ Nunca hardcode secrets — sempre via Valve
  • ✅ Defaults sensatos — a tool funciona com o mínimo de config
  • ❌ Não coloque secrets em UserValves (qualquer usuário vê a dele)

📖 Documentação completa na Wiki:

SinapseTech23
Related