Quando o 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 nunca fiquem expostas na trajetória do agente (os prompts e respostas trocados com modelos de terceiros) nem na sandbox da tarefa. Fornecer credenciais dentro de uma tarefa funciona em todos os clientes da Perplexity; as superfícies do cofre de credenciais para salvá-las e gerenciá-las estão disponíveis 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 e parâmetros de consulta. Se você fornecer um nome de usuário e uma senha, o Computer os combina em uma credencial Authorization bearer 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 nunca fica exposto à atividade do agent ou ao ambiente isolado da tarefa. Você escolhe por quanto tempo uma credencial deve permanecer disponível: apenas para esta tarefa, salva no seu cofre pessoal para reutilização ou compartilhada com um projeto para que sua equipe também possa 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 anexa com sua aprovação — ou automaticamente para consultas que exigirem isso, se você tiver configurado a aprovação automática.
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 nunca aparece na atividade do agente nem na 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.
Observação: "text": "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."
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.
-
Cofre de credenciais (pessoal): Salvo no seu cofre pessoal de Credenciais 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 nunca fica visível na atividade do agente nem na sandbox.
-
Dura durante toda a tarefa. Uma vez adicionado, o 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.
Credenciais do cofre do usuário (pessoais, reutilizáveis)
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-o diretamente. Ir para Configurações > Cofre de credenciais para adicionar e gerenciar credenciais fora de uma tarefa.
-
Aprovar antes de cada reutilização. Por padrão, o Computer reconhece sua credencial salva e solicita sua aprovação explícita antes de usá-la. Você pode selecionar Sempre permitir para contornar a aprovação explícita toda vez que a credencial for necessária.
-
Permanece privado para você. As credenciais do cofre do usuário pertencem à sua conta e não são compartilhadas com mais ninguém.
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 isso no projeto. As credenciais do projeto são definidas na barra lateral do projeto, na seção Credenciais.
-
Todos no projeto podem usá-lo. 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.
-
Aprovar antes de cada uso. Dentro de uma tarefa, o Computer sempre pede sua aprovação antes de usar uma credencial de projeto. Você pode configurar Sempre permitir para contornar esta etapa.
Gerenciando suas credenciais
-
Encontre seu cofre em Configurações > Cofre de credenciais. Seu cofre pessoal de Credenciais fica nas configurações da sua conta. Você também pode acessá-lo na página de Conectores — clique em Adicionar uma conexão personalizada menu suspenso e depois clique Conecte sua própria API.
-
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 nas configurações de conectores desse projeto. Você deve ter, no mínimo, permissão de editor 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 nunca é exposto à atividade do agente nem ao sandbox da tarefa.
-
"{\"text\": \"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.
-
É necessária aprovação para credenciais salvas. Computer solicita sua aprovação explícita antes de usar uma credencial salva do usuário ou do projeto em uma tarefa, a menos que você escolha explicitamente Sempre permitir para contornar a aprovação explícita toda vez que a credencial for necessária.
-
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.
-
As credenciais do projeto são compartilhadas com o projeto. Qualquer pessoa com acesso a um projeto pode usar suas credenciais em suas próprias tarefas, então adicione apenas chaves que você pretende compartilhar com essa equipe.
Perguntas frequentes
Qual é a diferença entre uma credencial de sessão, de usuário e de projeto?
Uma credencial de sessão é usada apenas na tarefa atual e não é salva. Uma credencial de cofre do usuário é salva na sua conta pessoal e pode ser reutilizada nas suas próprias tarefas, com sua aprovação a cada vez. Uma credencial de projeto é salva em um projeto para que todos nessa equipe possam usá-la, novamente com aprovação antes de cada uso.
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 nunca fica visível para a atividade do agente nem para o ambiente isolado da tarefa.
Por que o Computer está me pedindo para aprovar uma credencial?
Para credenciais salvas, o Computer solicita sua aprovação explícita antes de usar uma credencial do cofre do usuário ou do projeto em uma tarefa. Isso mantém você no controle de quando suas chaves salvas são usadas. Você pode configurar o Computer para ignorar solicitações de aprovação para credenciais específicas — para fazer isso, selecione Sempre permitir nas configurações da credencial específica no seu cofre de Credenciais.
Como reutilizo uma credencial em uma tarefa futura?
Salve-o no seu Credential vault quando o Computer solicitar, ou adicione-o diretamente do vault. Em tarefas posteriores, o Computer o reconhecerá e pedirá que você aprove seu uso.
Onde encontro meu Credential vault?
Seu cofre pessoal de credenciais fica nas configurações da sua conta. Você também pode abri-lo na página Conectores usando a opção para adicionar uma conexão personalizada ou conectar sua própria API.
Meus colegas de equipe podem usar minhas chaves?
"Only if you add them as project credentials. As credenciais do usuário são privadas à sua conta. As credenciais do projeto podem ser usadas por todos no projeto, e você precisa ter pelo menos permissão de writer no projeto para adicioná-las ou revogá-las."
Posso armazenar outros segredos, como uma chave SSH?
No momento, não. O suporte a credenciais personalizadas oferece 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 usa para criar uma credencial bearer de Authorization 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, headers personalizados ou parâmetros de consulta. 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.