Chat e modelos

Um chat combina uma tarefa, seu histórico, um modelo de provedor, contexto do projeto e as capacidades que você permite. Use um chat por resultado coerente para manter o contexto e a revisão compreensíveis.

Conectar um provedor

Em Configurações, adicione um provedor compatível com sua própria conta, assinatura ou credenciais de API. Conclua a autorização do provedor e confirme que a conexão está pronta. As solicitações de inferência trafegam diretamente do app para esse provedor; o Maestrly não tem backend hospedado e não revende acesso a modelos. A autenticação e a retenção seguem os termos do provedor.

Se a autenticação falhar, verifique a credencial, o status da conta, a região e qualquer organização ou projeto selecionado no provedor.

Escolher um modelo

Escolha um modelo ao criar um chat ou no controle de modelo do chat. Combine o modelo com o trabalho:

use opções mais rápidas e econômicas para exploração e pequenas edições;
use opções de raciocínio mais capazes para mudanças amplas, ambíguas ou de maior risco;
confira se o modelo aceita as ferramentas, o tamanho de contexto ou as mídias necessárias para a tarefa.

A lista pode variar por conta, plano, região e disponibilidade atual do provedor. Exibir um modelo pelo nome não representa endosso nem garantia de que sua conta possa usá-lo.

Escrever a primeira solicitação

Inclua quatro elementos:

Resultado — o que deve ser verdade quando o trabalho terminar.
Escopo — o projeto, arquivos ou áreas que o agente pode alterar.
Restrições — convenções, requisitos de compatibilidade e ações a evitar.
Verificação — testes, comandos ou evidências esperadas antes da conclusão.

Anexe apenas o contexto relevante. Contexto grande e sem relação consome a janela do provedor e pode deixar o resultado menos focado.

Trocar de modelo com intenção

Antes de trocar o modelo de um chat ativo, resuma decisões pendentes e o estado atual. Confirme que o modelo de destino aceita as ferramentas necessárias. Depois da troca, confira o entendimento do agente antes de autorizar ações importantes.

Resolver falhas numa solicitação

Não autorizado ou proibido: reconecte o provedor e verifique permissões da conta, projeto, organização ou modelo.
Modelo indisponível: escolha outro modelo disponível ou confira o status e o acesso regional no provedor.
Limite de taxa ou cota: aguarde, reduza o trabalho paralelo ou ajuste os limites na conta do provedor.
Contexto grande demais: remova anexos sem relação, divida a tarefa ou abra um chat focado com um resumo conciso.
Ferramenta incompatível: escolha um modelo compatível ou remova essa capacidade da tarefa.

Os logs e painéis de cobrança do provedor são a fonte oficial para status e custos das solicitações. Veja Uso e custos.