Quando Perplexity Computer deve raggiungere un’API di terze parti che non dispone di un connettore integrato, puoi fornire in modo sicuro le tue credenziali API. Le tue chiavi vengono crittografate e archiviate, così non vengono condivise nella traiettoria dell’agente (i prompt e le risposte scambiati con modelli di terze parti) né con la sandbox dell’attività. Fornire credenziali all’interno di un’attività funziona su tutti i client Perplexity; il Vault delle credenziali, in cui le salvi e le gestisci, è disponibile sul web.
Panoramica
Alcuni strumenti che vuoi che Computer utilizzi non dispongono ancora di un connettore integrato. Le credenziali personalizzate ti consentono di usare la tua credenziale API in modo che Computer possa autenticarsi a quel servizio per tuo conto — ad esempio, per inviare un’email transazionale, recuperare dati da un’API di analisi o consultare i punteggi sportivi da un fornitore di dati. Computer supporta i metodi di autenticazione utilizzati da queste API: token, intestazioni personalizzate, parametri di query e nome utente e password. Se fornisci un nome utente e una password, Computer li salva come credenziale Basic auth così da potersi autenticare all’API in modo sicuro.
Quando un’attività richiede credenziali, Computer ti chiede di compilare un modulo sicuro. La tua credenziale viene crittografata e inserita nelle richieste API in uscita tramite un proxy sicuro, così il valore non elaborato non viene condiviso con l’agente né con la sandbox dell’attività. Puoi scegliere per quanto tempo una credenziale rimane disponibile: solo per questa attività, salvata nel tuo vault personale per il riutilizzo, oppure condivisa con un progetto così che anche i tuoi colleghi possano usarla. Una credenziale che aggiungi in un’attività rimane disponibile per la durata della sessione di Computer, e puoi revocarla in qualsiasi momento. Se la salvi nel tuo vault personale, Computer la usa automaticamente quando un’attività ne ha bisogno, perché le nuove credenziali sono impostate su Consenti sempre. Puoi impostare una credenziale su Chiedi approvazione nel tuo Vault delle credenziali.
Perché usare credenziali personalizzate?
Connetti servizi senza un connettore integrato. Usa la tua chiave API per uno strumento di terze parti così Computer può lavorarci subito.
Mantieni i segreti fuori dalla vista dell’agente. Le credenziali vengono crittografate e inserite tramite un proxy sicuro, quindi il valore non elaborato non viene condiviso con l’agente né con la sandbox.
Riutilizza le chiavi tra le tue attività. Salva una credenziale una sola volta nel tuo vault personale e lascia che Computer la riutilizzi nelle attività future.
Condividi l’accesso con un progetto. Aggiungi una credenziale a un progetto così tutto il team può usarla, senza condividere la chiave non elaborata.
Mantieni il controllo. Per ogni credenziale salvata, puoi scegliere se consentire a Computer di usarla senza la tua approvazione oppure chiedere a Computer di richiedere la tua approvazione prima di usarla in un’attività.
Prima di aggiungere una credenziale personalizzata, verifica se il servizio dispone già di un connettore integrato. I connettori sono il modo preferito per collegare un servizio di terze parti, e Computer ne userà uno quando disponibile. Usa le credenziali personalizzate per i servizi che non dispongono ancora di un connettore.
Se il servizio ha un connettore integrato, quel connettore può comparire anche all’interno di un plugin. Collegandolo in un punto, lo colleghi ovunque per il tuo account. La connessione e le impostazioni dei connettori della tua organizzazione si applicano in ogni plugin. Consulta Che cosa sono i plugin?
I tre ambiti delle credenziali
Le credenziali rientrano in tre ambiti, in base alla loro durata e a chi può usarle:
Sessione (attività singola): Usata solo all’interno dell’attività corrente e non salvata per il riutilizzo.
Personale (Vault delle credenziali): Salvata nel tuo vault delle credenziali personale e riutilizzabile nelle tue attività.
Progetto (condiviso): Salvata in un progetto così tutto il team può usarla.
Le sezioni seguenti spiegano come funziona ciascuna di esse.
Credenziali di Sessione (attività singola)
Le credenziali di sessione sono l’opzione più semplice: fornisci una chiave per una sola attività e non viene salvata.
Ti viene richiesto durante l’attività. Quando un’attività richiede una credenziale, Computer mostra un modulo sicuro in cui inserirla. Compila automaticamente i dettagli come host, nome e tipo di credenziale, quando possibile.
Viene crittografata e trasmessa tramite proxy. La tua credenziale viene crittografata e inserita nelle richieste API in uscita tramite un proxy sicuro, quindi il valore in chiaro non viene condiviso con l’agente né con la sandbox.
Vale per l’intera attività. Una volta aggiunta, la credenziale è disponibile per il resto di quell’attività, incluse le richieste di follow-up.
Non viene salvata. Le credenziali di sessione non vengono archiviate per essere riutilizzate: avvia una nuova attività e ti verrà richiesto di inserirle di nuovo. Se vuoi riutilizzarla in futuro, avrai la possibilità di salvare la credenziale nel tuo vault.
Figura 1 — Il modulo sicuro che Computer mostra in un’attività quando ha bisogno di una credenziale.
Credenziali personali (Vault delle credenziali)
Salva una credenziale nel tuo vault personale per riutilizzarla nelle tue attività senza doverla reinserire ogni volta.
Salva dal modulo dell’attività. Quando Computer ti richiede una credenziale, scegli l’opzione per salvarla nel tuo vault delle credenziali e riutilizzarla nelle attività di Computer.
Oppure aggiungila direttamente. Vai a Impostazioni > Vault delle credenziali per aggiungere e gestire le credenziali al di fuori di un’attività.
Scegli quando Computer chiede. Le nuove credenziali sono impostate su Consenti sempre, quindi Computer riconosce la tua credenziale salvata e la usa quando un’attività ne ha bisogno. Per approvare invece ogni utilizzo, imposta la credenziale su Chiedi approvazione nel tuo Vault delle credenziali.
Rimane privata per te. Le credenziali personali appartengono al tuo account e non sono condivise con nessun altro.
Figura 2 — Credenziali salvate nel Vault delle credenziali, ciascuna con la propria impostazione di approvazione.
Credenziali del Progetto (condivise con un team)
Aggiungi una credenziale a un Progetto in modo che tutti coloro che lavorano in quel Progetto possano usarla — utile per una chiave condivisa su cui il tuo team fa affidamento.
Aggiungila nel Progetto. Nella barra laterale del Progetto, trova la sezione Vault delle credenziali e seleziona Manage per aggiungere una credenziale del Progetto.
Tutti nel Progetto possono usarla. Tutti i membri del Progetto possono usare la credenziale nelle proprie attività, senza vedere il valore in chiaro.
La gestiscono gli autori. Devi essere almeno un autore del Progetto per aggiungere o revocare una credenziale del Progetto, seguendo le stesse regole di accesso dei connettori del Progetto.
Scegli quando Computer chiede. Le nuove credenziali del Progetto sono impostate su Consenti sempre, quindi Computer può usarle in un’attività senza chiedere. Imposta una credenziale su Chiedi approvazione se vuoi che Computer chieda prima di ogni utilizzo.
Figura 3 — Le credenziali del Progetto nella barra laterale del Progetto.
Gestione delle credenziali
Trova il tuo vault in Impostazioni > Vault delle credenziali. Il tuo Vault delle credenziali personale si trova nelle impostazioni del tuo account. Se vedi Plugin nella barra laterale, potresti anche poterlo aprire da lì: seleziona Aggiungi personalizzato, poi Collega la tua API personalizzata. Questa opzione compare solo se il tuo piano e le impostazioni della tua organizzazione consentono i connettori personalizzati.
Aggiungi, esamina o rimuovi le chiavi. Apri il deposito credenziali per aggiungere una nuova credenziale, esaminare quelle che hai salvato o rimuovere quella di cui non hai più bisogno.
Gestisci le credenziali del progetto nel Progetto. Aggiungi o revoca le credenziali di un progetto dalla sezione Vault delle credenziali nella barra laterale del Progetto. Devi avere almeno il ruolo di writer nel progetto.
Limiti e privacy
La tua chiave grezza rimane nascosta. Le credenziali sono crittografate e iniettate tramite un proxy sicuro, quindi il valore grezzo non viene condiviso con l’agente né con il sandbox dell’attività.
Solo richieste API. Le credenziali personalizzate sono supportate per le richieste API che Computer può instradare tramite il proxy sicuro. Altri tipi di segreti, come le chiavi SSH, non sono attualmente supportati.
Per impostazione predefinita, le credenziali salvate sono impostate su Consenti sempre. Computer usa in un’attività una credenziale salvata personale o del progetto senza chiedere, a meno che tu non imposti quella credenziale su Chiedi approvazione. Le credenziali salvate prima di questa impostazione predefinita mantengono l’impostazione che avevano già.
Le credenziali di sessione non vengono archiviate. Una credenziale di sessione viene usata solo all’interno di quella sessione di Computer, può essere revocata in qualsiasi momento e non viene salvata per il riutilizzo in sessioni successive, a meno che tu non scelga esplicitamente di salvarla nel tuo deposito credenziali.
Domande frequenti
Qual è la differenza tra una credenziale di sessione, personale e del progetto?
Una credenziale di sessione viene usata solo nell’attività corrente e non viene salvata. Una credenziale personale viene salvata nel tuo Vault delle credenziali ed è riutilizzabile in tutte le tue attività. Una credenziale del progetto viene salvata in un Progetto così che tutti nel team possano usarla. Per impostazione predefinita, le credenziali salvate sono impostate su Consenti sempre e puoi passare qualsiasi credenziale a Chiedi approvazione.
Dovrei usare un connettore o una credenziale personalizzata?
Se il servizio dispone di un connettore integrato, usa il connettore: è il modo preferito per collegare un servizio di terze parti. Usa una credenziale personalizzata quando non è disponibile alcun connettore per lo strumento di cui hai bisogno.
Computer può vedere la mia chiave API?
No. La tua credenziale viene crittografata e iniettata nelle richieste in uscita tramite un proxy sicuro, quindi il valore grezzo non viene condiviso con l’agente né con il sandbox dell’attività. Se un’API include la tua credenziale nella sua risposta, ad esempio rimandando indietro le intestazioni della richiesta, Computer può vedere quella risposta.
Perché Computer mi chiede di approvare una credenziale?
Computer chiede l’approvazione solo quando una credenziale salvata personale o del progetto è impostata su Chiedi approvazione. Le nuove credenziali sono impostate su Consenti sempre, ma quelle salvate prima di questa impostazione predefinita mantengono l’impostazione che avevano già. Per interrompere le richieste per una credenziale, seleziona Consenti sempre nelle impostazioni di quella credenziale nel tuo deposito credenziali.
Come faccio a riutilizzare una credenziale in un’attività futura?
Salvala nel tuo deposito credenziali quando Computer te lo chiede, oppure aggiungila direttamente dal deposito. Nelle attività successive, Computer la riconosce e la usa, oppure ti chiede prima conferma se la credenziale è impostata su Chiedi approvazione.
Dove trovo il mio deposito credenziali?
Vai a Impostazioni > Vault delle credenziali. Se vedi Plugin nella barra laterale, potresti anche poterlo aprire da lì: seleziona Aggiungi personalizzato, poi Collega la tua API personalizzata. Questa opzione compare solo se il tuo piano e le impostazioni della tua organizzazione consentono i connettori personalizzati.
I miei colleghi possono usare le mie chiavi?
Sì, se le aggiungi come credenziali del progetto. Le credenziali personali sono private del tuo account. Le credenziali del progetto possono essere usate da tutti nel Progetto e devi avere almeno il ruolo di writer nel Progetto per aggiungerle o revocarle.
Posso archiviare altri segreti, come una chiave SSH?
No. Le credenziali personalizzate supportano le richieste API instradate tramite il proxy sicuro. Altri formati di segreto, come le chiavi SSH, non sono attualmente supportati.
Il nome utente e la password sono gli stessi delle mie credenziali di accesso al sito web di quel servizio?
No. Quando fornisci un nome utente e una password, Computer li salva come credenziale Basic auth per l’autenticazione all’API del servizio: non si tratta di un accesso generico per entrare nel sito web di quel servizio. Le credenziali personalizzate vengono usate solo per autenticare le richieste API, tramite token, intestazioni personalizzate, parametri di query o Basic auth. Se non sei sicuro di quale valore inserire, consulta la documentazione dell’API per verificare come si aspetta che vengano autenticate le richieste.
Articoli correlati
Hai bisogno di ulteriore aiuto?
Contattaci tramite Help > Contact Support. Includi il link dell’attività se la tua domanda riguarda una specifica attività di Computer.