Quando o Perplexity Computer precisar acessar uma API de terceiros que não tenha um conector integrado, você pode fornecer com segurança suas próprias credenciais de API. Suas chaves são criptografadas e armazenadas para que não sejam compartilhadas na trajetória do agente (os prompts e respostas trocados com modelos de terceiros) nem com a sandbox da tarefa. Fornecer credenciais dentro de uma tarefa funciona em todos os clientes da Perplexity; o Cofre de credenciais, onde você as salva e gerencia, está disponível na web.
Visão geral
Algumas ferramentas que você quer que o Computer use ainda não terão um conector integrado. As credenciais personalizadas permitem que você use sua própria credencial de API para que o Computer possa se autenticar nesse serviço em seu nome — por exemplo, para enviar um e-mail transacional, extrair dados de uma API de análise ou consultar placares esportivos em um provedor de dados. O Computer é compatível com os métodos de autenticação usados por essas APIs: tokens, cabeçalhos personalizados, parâmetros de consulta e nomes de usuário e senhas. Se você fornecer um nome de usuário e uma senha, o Computer os salva como uma credencial Basic auth para que possa se autenticar na API com segurança.
Quando uma tarefa precisar de credenciais, o Computer exibe um formulário seguro. Sua credencial é criptografada e injetada nas solicitações de API de saída por meio de um proxy seguro, de modo que o valor bruto não é compartilhado com o agente nem com a sandbox da tarefa. Você escolhe por quanto tempo uma credencial dura: apenas para esta tarefa, salva no seu cofre pessoal para reutilização ou compartilhada com um projeto para que seus colegas também possam usá-la. Uma credencial que você adicionar em uma tarefa permanece disponível durante toda a sessão do Computer, e você pode revogá-la a qualquer momento. Se você salvá-la no seu cofre pessoal, o Computer a usa automaticamente quando uma tarefa precisar dela, porque novas credenciais são definidas como Sempre permitir. Você pode mudar uma credencial para Pedir aprovação no seu Cofre de credenciais.
Por que usar credenciais personalizadas?
Conecte serviços sem um conector nativo. Traga sua própria chave de API para uma ferramenta de terceiros para que o Computer possa usá-la imediatamente.
Mantenha segredos fora do campo de visão do agente. As credenciais são criptografadas e injetadas por meio de um proxy seguro, de modo que o valor bruto não é compartilhado com o agente nem com a sandbox.
Reutilize chaves entre suas tarefas. Salve uma credencial no seu cofre pessoal uma vez e deixe o Computer reutilizá-la em tarefas futuras.
Compartilhe o acesso com um projeto. Adicione uma credencial a um projeto para que todos da equipe possam usá-la, sem compartilhar a chave bruta.
Mantenha o controle. Para cada credencial salva, você pode escolher se quer permitir que o Computer a use sem sua aprovação ou se quer que o Computer peça sua aprovação antes de usá-la em uma tarefa.
Antes de adicionar uma credencial personalizada, verifique se o serviço já possui um conector nativo. Conectores são a forma preferida de vincular um serviço de terceiros, e o Computer usará um quando ele estiver disponível. Use credenciais personalizadas para serviços que ainda não têm um conector.
Se o serviço tiver um conector nativo, esse conector também pode aparecer dentro de um plugin. Ao conectá-lo em qualquer lugar, ele fica conectado para sua conta em todos os lugares. Sua conexão e as configurações de conectores da sua organização se aplicam em todos os plugins. Consulte O que são plugins?
Os três escopos de credenciais
As credenciais vêm em três escopos, com base em quanto tempo duram e quem pode usá-las:
Sessão (tarefa única): Usado apenas dentro da tarefa atual e não salvo para reutilização.
Pessoal (Cofre de credenciais): Salvo no seu Cofre de credenciais pessoal e reutilizável em suas próprias tarefas.
Projeto (compartilhado): Salvo em um projeto para que todos na equipe possam usá-lo.
As seções abaixo explicam como cada uma funciona.
Credenciais da sessão (tarefa única)
As credenciais de sessão são a opção mais simples: você fornece uma chave para uma tarefa, e ela não é salva.
Você está sendo solicitado na tarefa. Quando uma tarefa precisa de uma credencial, o Computer exibe um formulário seguro para você inseri-la. Ele preenche automaticamente, quando possível, detalhes como o host, o nome e o tipo da credencial.
Está criptografado e passa por um proxy. Sua credencial é criptografada e injetada nas solicitações de API de saída por meio de um proxy seguro, de modo que o valor bruto não é compartilhado com o agente nem com a sandbox.
Dura durante toda a tarefa. Uma vez adicionada, a credencial fica disponível pelo restante dessa tarefa, incluindo solicitações de acompanhamento.
Não está salvo. As credenciais da sessão não são armazenadas para reutilização — inicie uma nova tarefa e você será solicitado novamente. Você terá a opção de salvar a credencial no seu cofre se quiser reutilizá-la no futuro.
Figura 1 — O formulário seguro que o Computer mostra em uma tarefa quando precisa de uma credencial.
Credenciais pessoais (Cofre de credenciais)
Salve uma credencial no seu cofre pessoal para reutilizá-la nas suas próprias tarefas sem precisar digitá-la novamente toda vez.
Salvar no formulário da tarefa. Quando o Computer solicitar suas credenciais, escolha a opção de salvá-las no seu cofre de credenciais para reutilizá-las em tarefas do Computer.
Ou adicione-a diretamente. Acesse Configurações > Cofre de credenciais para adicionar e gerenciar credenciais fora de uma tarefa.
Escolha quando o Computer pergunta. Novas credenciais são definidas como Sempre permitir, então o Computer reconhece sua credencial salva e a usa quando uma tarefa precisar dela. Para aprovar cada uso, mude a credencial para Pedir aprovação no seu Cofre de credenciais.
Permanece privado para você. As credenciais pessoais pertencem à sua conta e não são compartilhadas com mais ninguém.
Figura 2 — Credenciais salvas no Cofre de credenciais, cada uma com sua configuração de aprovação.
Credenciais do projeto (compartilhadas com uma equipe)
Adicione uma credencial a um projeto para que todos que trabalham nele possam usá-la — útil para uma chave compartilhada da qual sua equipe depende.
Adicione no projeto. Na barra lateral do projeto, encontre a seção Cofre de credenciais e selecione Manage para adicionar uma credencial do projeto.
Todos no projeto podem usá-la. Todos os membros do projeto podem usar a credencial em suas tarefas, sem ver o valor bruto.
Escritores a administram. Você precisa ser pelo menos escritor no projeto para adicionar ou revogar uma credencial do projeto, seguindo as mesmas regras de acesso dos conectores do projeto.
Escolha quando o Computer pergunta. Novas credenciais de projeto são definidas como Sempre permitir, então o Computer pode usá-las em uma tarefa sem perguntar. Mude uma credencial para Pedir aprovação se quiser que o Computer pergunte antes de cada uso.
Figura 3 — Credenciais do projeto na barra lateral do projeto.
Gerenciando suas credenciais
Encontre seu cofre em Configurações > Cofre de credenciais. Seu Cofre de credenciais pessoal fica nas configurações da sua conta. Se você vê Plugins na barra lateral, talvez também consiga abri-lo por lá: selecione Adicionar personalizado e depois Conecte sua própria API. Essa opção só aparece quando o seu plano e as configurações da sua organização permitem conectores personalizados.
Adicionar, revisar ou remover chaves. Abra o cofre de credenciais para adicionar uma nova credencial, revisar as que você salvou ou remover uma que não precisa mais.
Gerencie as credenciais do projeto no projeto. Adicione ou revogue as credenciais de um projeto na seção Cofre de credenciais da barra lateral do projeto. Você precisa ser pelo menos escritor no projeto.
Limites e privacidade
Sua chave bruta permanece oculta. As credenciais são criptografadas e injetadas por meio de um proxy seguro, portanto o valor bruto não é compartilhado com o agente nem com a sandbox da tarefa.
Solicitações de API apenas. Credenciais personalizadas são suportadas para solicitações de API que o Computer pode encaminhar por meio do proxy seguro. Outros tipos de segredo, como chaves SSH, não são suportados atualmente.
Credenciais salvas são definidas como Sempre permitir por padrão. O Computer usa uma credencial pessoal ou de projeto salva em uma tarefa sem perguntar, a menos que você mude essa credencial para Pedir aprovação. Credenciais salvas antes desse padrão mantêm a configuração que já tinham.
As credenciais da sessão não são armazenadas. Uma credencial de sessão é usada apenas dentro daquela sessão do Computer, pode ser revogada a qualquer momento e não é salva para reutilização em sessões posteriores, a menos que você escolha explicitamente salvar a credencial no seu Cofre de credenciais.
Perguntas frequentes
Qual é a diferença entre uma credencial de sessão, pessoal e de projeto?
Uma credencial de sessão é usada apenas na tarefa atual e não é salva. Uma credencial pessoal é salva no seu Cofre de credenciais e pode ser reutilizada nas suas próprias tarefas. Uma credencial de projeto é salva em um projeto para que todos nessa equipe possam usá-la. As credenciais salvas são definidas como Sempre permitir por padrão, e você pode mudar qualquer uma delas para Pedir aprovação.
Devo usar um conector ou uma credencial personalizada?
Se o serviço tiver um conector integrado, use o conector — essa é a forma preferencial de conectar um serviço de terceiros. Use uma credencial personalizada quando não houver um conector disponível para a ferramenta de que você precisa.
O Computer pode ver minha chave de API?
Não. Sua credencial é criptografada e inserida nas solicitações de saída por meio de um proxy seguro, então o valor bruto não é compartilhado com o agente nem com a sandbox da tarefa. Se uma API incluir sua credencial na resposta, por exemplo ao devolver os cabeçalhos da solicitação, o Computer pode ver essa resposta.
Por que o Computer está me pedindo para aprovar uma credencial?
O Computer pede aprovação somente quando uma credencial pessoal ou de projeto salva está definida como Pedir aprovação. Novas credenciais são definidas como Sempre permitir, mas credenciais salvas antes desse padrão mantêm a configuração que já tinham. Para parar de receber solicitações para uma credencial, selecione Sempre permitir nas configurações dessa credencial no seu Cofre de credenciais.
Como reutilizo uma credencial em uma tarefa futura?
Salve-a no seu Cofre de credenciais quando o Computer solicitar, ou adicione-a diretamente pelo cofre. Em tarefas posteriores, o Computer a reconhece e a usa, ou pergunta antes se a credencial estiver definida como Pedir aprovação.
Onde encontro meu Cofre de credenciais?
Acesse Configurações > Cofre de credenciais. Se você vê Plugins na barra lateral, talvez também consiga abri-lo por lá: selecione Adicionar personalizado e depois Conecte sua própria API. Essa opção só aparece quando o seu plano e as configurações da sua organização permitem conectores personalizados.
Meus colegas podem usar minhas chaves?
Sim, se você as adicionar como credenciais do projeto. As credenciais pessoais são privadas à sua conta. As credenciais do projeto podem ser usadas por todos no projeto, e você precisa ser pelo menos escritor no projeto para adicioná-las ou revogá-las.
Posso armazenar outros segredos, como uma chave SSH?
Não. As credenciais personalizadas oferecem suporte a solicitações de API que são roteadas pelo proxy seguro. Outros formatos de segredo, como chaves SSH, não são suportados atualmente.
O nome de usuário e a senha são os mesmos que eu uso para entrar no site desse serviço?
Não. Quando você fornece um nome de usuário e uma senha, o Computer os salva como uma credencial Basic auth para autenticar na API do serviço — isso não é um login de uso geral para entrar no site desse serviço. Credenciais personalizadas são usadas apenas para autenticar solicitações à API, usando tokens, cabeçalhos personalizados, parâmetros de consulta ou Basic auth. Se você não tiver certeza de qual valor inserir, consulte a documentação da API para ver como ela espera que as solicitações sejam autenticadas.
Artigos relacionados
Precisa de mais ajuda?
Fale com a gente em Help > Contact Support. Inclua o link da tarefa se a sua dúvida for sobre uma tarefa específica do Computer.