PluelyPluelyDocumentação

Configurações

Adicionar um provedor de IA personalizado

Os Provedores personalizados (IA) do Dev Space permitem que você “Crie e gerencie provedores de IA personalizados. Configure endpoints, autenticação e formatos de resposta.” Em resumo: traga qualquer provedor de IA de que você tenha uma chave de API e use-o direto na sobreposição do Pluely.

Como adicionar um provedor

  1. Abra o Dev Space. No Dev Pro, expanda Avançado: provedores de IA personalizados na parte de baixo; caso contrário, vá até Provedores personalizados em Provedores de IA. A maioria das pessoas nunca precisa disso: os serviços da etapa 2 (OpenAI, Anthropic, Gemini, OpenRouter, Groq, xAI, Mistral, Perplexity, Ollama) só precisam de uma chave.

  2. Clique para adicionar um novo provedor. Um campo Nome é preenchido automaticamente, mas você pode trocá-lo por qualquer nome que ajude a diferenciar os provedores depois.

  3. Cole a solicitação do seu provedor como Comando curl * (descrito no Pluely como “O comando curl a ser usado com o provedor de IA.”). Essa é a solicitação exata que o Pluely vai enviar, incluindo o seu endpoint e a autenticação, então confira se a chave e os cabeçalhos que você usa aqui estão corretos e funcionando. Coloque {{TEXT}} onde a sua pergunta entra; {{IMAGE}} e {{SYSTEM_PROMPT}} são opcionais. Preencher automaticamente começa a partir do modelo de um provedor conhecido. Endpoints que não enviam cabeçalhos CORS também funcionam: o Pluely faz a solicitação fora da webview, do mesmo jeito que o curl.

  4. Preencha o Caminho do conteúdo da resposta * (descrito como “O caminho para extrair o conteúdo da resposta da API.”). Ele diz ao Pluely exatamente onde, dentro da resposta JSON, fica o texto da resposta do seu provedor. O valor de exemplo exibido é:

    choices[0].message.content

    que aponta para o texto da mensagem dentro de uma resposta JSON típica no estilo chat completion: a primeira opção, a mensagem dela e o conteúdo dessa mensagem.

  5. Ajuste a chave Streaming. Como o Pluely descreve, “O streaming é usado para transmitir a resposta do provedor de IA.” Ative-a se o seu provedor envia a saída aos poucos, conforme gera; deixe-a desativada se ele devolve a resposta completa de uma vez.

  6. Salve. O novo provedor passa a aparecer em “Seus provedores (Dev Space)” no seletor “Selecione um modelo” da sobreposição.

Entenda o caminho do conteúdo da resposta

Todo provedor de IA devolve a resposta em JSON, mas o lugar exato em que o texto da resposta fica dentro desse JSON muda conforme o provedor e o endpoint. O caminho do conteúdo da resposta é como você diz ao Pluely exatamente onde procurar. O exemplo integrado,

   choices[0].message.content

é um caminho: pegue o primeiro item de um array choices, depois o objeto message dele e, por fim, o campo content desse objeto. Se a resposta do seu provedor tiver outro formato, ajuste o caminho para onde o seu provedor de fato coloca o texto da resposta.

Como editar e excluir

Depois de salvar um provedor personalizado, você pode abri-lo de novo para Editar provedor: atualize o comando curl, o caminho do conteúdo da resposta ou a chave de streaming se a configuração do seu provedor mudar. Use Excluir provedor para remover um de que não precisa mais; ele some de “Seus provedores (Dev Space)” no seletor de modelos.

Relacionados

Última atualização: 10 de julho de 2026 · pluely.com