Lorsque Perplexity Computer doit accéder à une API tierce qui ne dispose pas d’un connecteur intégré, vous pouvez fournir en toute sécurité vos propres identifiants API. Vos clés sont chiffrées et stockées de sorte qu’elles ne soient pas partagées dans la trajectoire de l’agent (les prompts et réponses échangés avec des modèles tiers) ni avec le bac à sable de la tâche. La fourniture d’identifiants au sein d’une tâche fonctionne sur tous les clients Perplexity ; le coffre-fort d’identifiants, où vous les enregistrez et les gérez, est disponible sur le web.
Vue d’ensemble
Certains outils que vous souhaitez faire utiliser à Computer n’ont pas encore de connecteur intégré. Les identifiants personnalisés vous permettent d’apporter votre propre identifiant API afin que Computer puisse s’authentifier auprès de ce service en votre nom — par exemple, pour envoyer un e-mail transactionnel, récupérer des données depuis une API d’analyse ou consulter les résultats sportifs auprès d’un fournisseur de données. Computer prend en charge les méthodes d’authentification utilisées par ces API : jetons, en-têtes personnalisés, paramètres de requête, et noms d’utilisateur et mots de passe. Si vous fournissez un nom d’utilisateur et un mot de passe, Computer les enregistre en tant qu’identifiant Basic auth afin de pouvoir s’authentifier de manière sécurisée auprès de l’API.
Lorsqu’une tâche nécessite des identifiants, Computer vous invite à les saisir via un formulaire sécurisé. Votre identifiant est chiffré et injecté dans les requêtes API sortantes via un proxy sécurisé, de sorte que la valeur brute n’est pas partagée avec l’agent ni avec le bac à sable de la tâche. Vous choisissez la durée de validité d’un identifiant : uniquement pour cette tâche, enregistré dans votre coffre personnel pour être réutilisé, ou partagé avec un projet afin que vos collègues puissent également l’utiliser. Un identifiant que vous ajoutez dans une tâche reste disponible pendant toute la durée de la session Computer, et vous pouvez le révoquer à tout moment. Si vous l’enregistrez dans votre coffre personnel, Computer l’utilise automatiquement lorsqu’une tâche en a besoin, car les nouveaux identifiants sont réglés sur Toujours autoriser. Vous pouvez passer un identifiant sur Demander une approbation dans votre coffre-fort d’identifiants.
Pourquoi utiliser des identifiants personnalisés ?
Connectez des services sans connecteur intégré. Apportez votre propre clé API pour un outil tiers afin que Computer puisse l’utiliser immédiatement.
Gardez les secrets hors de la vue de l’agent. Les identifiants sont chiffrés et injectés via un proxy sécurisé, de sorte que la valeur brute n’est pas partagée avec l’agent ni avec le bac à sable.
Réutilisez les clés dans vos tâches. Enregistrez une fois un identifiant dans votre coffre-fort personnel et laissez Computer le réutiliser dans de futures tâches.
Partagez l’accès avec un projet. Ajoutez un identifiant à un projet afin que toute l’équipe puisse l’utiliser, sans partager la clé brute.
Gardez le contrôle. Pour chaque identifiant enregistré, vous pouvez choisir d’autoriser Computer à l’utiliser sans votre approbation ou de demander à Computer de solliciter votre approbation avant de l’utiliser dans une tâche.
Avant d’ajouter un identifiant personnalisé, vérifiez si le service dispose déjà d’un connecteur intégré. Les connecteurs sont la méthode privilégiée pour relier un service tiers, et Computer en utilisera un lorsqu’il est disponible. Utilisez des identifiants personnalisés pour les services qui ne disposent pas encore d’un connecteur.
Si le service dispose d’un connecteur intégré, ce connecteur peut aussi apparaître dans un plugin. Le connecter à un endroit le connecte partout pour votre compte, et votre connexion ainsi que les paramètres de connecteurs de votre organisation s’appliquent dans chaque plugin. Consultez Que sont les plugins ?
Les trois périmètres d’identifiants
Les identifiants existent dans trois périmètres, selon leur durée de validité et les personnes qui peuvent les utiliser :
Session (tâche unique) : Utilisé uniquement dans la tâche en cours, et non enregistré pour une réutilisation.
Personnel (coffre-fort d’identifiants) : Enregistré dans votre coffre-fort d’identifiants personnel et réutilisable dans l’ensemble de vos propres tâches.
Projet (partagé) : Enregistré dans un projet afin que toute l’équipe puisse l’utiliser.
Les sections ci-dessous expliquent le fonctionnement de chacun d’eux.
Identifiants de session (tâche unique)
Les identifiants de session sont l’option la plus simple : vous fournissez une clé pour une tâche, et elle n’est pas enregistrée.
Vous êtes invité dans la tâche. Lorsqu’une tâche nécessite des identifiants, Computer affiche un formulaire sécurisé pour que vous les saisissiez. Il préremplit autant que possible les informations telles que l’hôte, le nom et le type d’identifiant.
Il est chiffré et relayé via un proxy. Votre identifiant est chiffré et injecté dans les requêtes API sortantes via un proxy sécurisé, de sorte que la valeur brute n’est pas partagée avec l’agent ni avec le bac à sable.
Il reste disponible pendant toute la tâche. Une fois ajouté, l’identifiant est disponible pour le reste de cette tâche, y compris pour les demandes de suivi.
Il n’est pas enregistré. Les identifiants de session ne sont pas stockés pour être réutilisés — démarrez une nouvelle tâche et vous serez à nouveau invité. Vous aurez la possibilité d’enregistrer l’identifiant dans votre coffre-fort si vous souhaitez le réutiliser ultérieurement.
Figure 1 — Le formulaire sécurisé que Computer affiche dans une tâche lorsqu’il a besoin d’un identifiant.
Identifiants personnels (coffre-fort d’identifiants)
Enregistrez un identifiant dans votre coffre personnel afin de le réutiliser dans vos propres tâches sans avoir à le ressaisir à chaque fois.
Enregistrez depuis le formulaire de tâche. Lorsque Computer vous demande des identifiants, choisissez l’option permettant de les enregistrer dans votre coffre-fort d’identifiants afin de les réutiliser dans l’ensemble de vos tâches Computer.
Ou ajoutez-le directement. Accédez à Paramètres > Coffre-fort d’identifiants pour ajouter et gérer des identifiants en dehors d’une tâche.
Choisissez quand Computer vous demande. Les nouveaux identifiants sont réglés sur Toujours autoriser : Computer reconnaît donc vos identifiants enregistrés et les utilise lorsqu’une tâche en a besoin. Pour approuver chaque utilisation, passez plutôt l’identifiant sur Demander une approbation dans votre coffre-fort d’identifiants.
Ils restent privés. Les identifiants personnels appartiennent à votre compte et ne sont partagés avec personne d’autre.
Figure 2 — Les identifiants enregistrés dans le coffre-fort d’identifiants, chacun avec son réglage d’approbation.
Identifiants du projet (partagés avec une équipe)
Ajoutez un identifiant à un projet afin que toutes les personnes qui y travaillent puissent l’utiliser — pratique pour une clé partagée sur laquelle votre équipe s’appuie.
Ajoutez-le dans le projet. Dans la barre latérale du projet, repérez la section Coffre-fort d’identifiants et sélectionnez Gérer pour ajouter un identifiant de projet.
Tout le monde dans le projet peut l’utiliser. Tous les membres du projet peuvent utiliser l’identifiant dans leurs tâches, sans voir la valeur brute.
Les rédacteurs le gèrent. Vous devez au minimum être rédacteur sur le projet pour ajouter ou révoquer un identifiant de projet, selon les mêmes règles d’accès que pour les connecteurs de projet.
Choisissez quand Computer vous demande. Les nouveaux identifiants de projet sont réglés sur Toujours autoriser : Computer peut donc les utiliser dans une tâche sans vous le demander. Passez un identifiant sur Demander une approbation si vous souhaitez que Computer vous demande avant chaque utilisation.
Figure 3 — Les identifiants du projet dans la barre latérale du projet.
Gérer vos identifiants
Trouvez votre coffre-fort dans Paramètres > Coffre-fort d’identifiants. Votre coffre-fort d’identifiants personnel se trouve dans les paramètres de votre compte. Si Plugins apparaît dans la barre latérale, vous pourrez peut-être aussi l’ouvrir depuis cet endroit : sélectionnez Ajouter un élément personnalisé, puis Connectez votre propre API. Cette option n’apparaît que si votre forfait et les paramètres de votre organisation autorisent les connecteurs personnalisés.
Ajoutez, consultez ou supprimez des clés. Ouvrez le coffre-fort d’identifiants pour ajouter un nouvel identifiant, consulter ceux que vous avez enregistrés ou en supprimer un dont vous n’avez plus besoin.
Gérez les identifiants du projet dans le projet. Ajoutez ou révoquez les identifiants d’un projet depuis la section Coffre-fort d’identifiants de la barre latérale du projet. Vous devez au minimum avoir le rôle de rédacteur sur le projet.
Limites et confidentialité
Votre clé brute reste masquée. Les identifiants sont chiffrés et injectés via un proxy sécurisé, de sorte que la valeur brute n’est pas partagée avec l’agent ni avec le bac à sable de la tâche.
Requêtes API uniquement. Les identifiants personnalisés sont pris en charge pour les requêtes API que Computer peut acheminer via le proxy sécurisé. D’autres types de secrets, tels que les clés SSH, ne sont pas pris en charge à ce jour.
Les identifiants enregistrés sont réglés sur Toujours autoriser par défaut. Computer utilise un identifiant personnel ou de projet enregistré dans une tâche sans vous le demander, sauf si vous passez cet identifiant sur Demander une approbation. Les identifiants enregistrés avant l’introduction de ce réglage par défaut conservent leur réglage actuel.
Les identifiants de session ne sont pas stockés. Un identifiant de session est utilisé uniquement dans cette session Computer, peut être révoqué à tout moment et n’est pas enregistré pour être réutilisé lors de sessions ultérieures, sauf si vous choisissez explicitement d’enregistrer l’identifiant dans votre coffre-fort d’identifiants.
Questions fréquentes
Quelle est la différence entre un identifiant de session, personnel et de projet ?
Un identifiant de session n’est utilisé que dans la tâche en cours et n’est pas enregistré. Un identifiant personnel est enregistré dans votre coffre-fort d’identifiants et peut être réutilisé dans vos propres tâches. Un identifiant de projet est enregistré dans un projet afin que tous les membres de cette équipe puissent l’utiliser. Les identifiants enregistrés sont réglés sur Toujours autoriser par défaut, et vous pouvez passer n’importe lequel d’entre eux sur Demander une approbation.
Dois-je utiliser un connecteur ou des identifiants personnalisés ?
Si le service dispose d’un connecteur intégré, utilisez ce connecteur — c’est la méthode privilégiée pour connecter un service tiers. Utilisez des identifiants personnalisés lorsqu’aucun connecteur n’est disponible pour l’outil dont vous avez besoin.
Computer peut-il voir ma clé API ?
Non. Vos identifiants sont chiffrés et injectés dans les requêtes sortantes via un proxy sécurisé, de sorte que la valeur brute n’est pas partagée avec l’agent ni avec le bac à sable de la tâche. Si une API inclut votre identifiant dans sa réponse, par exemple en renvoyant les en-têtes de la requête, Computer peut voir cette réponse.
Pourquoi Computer me demande-t-il d’approuver des identifiants ?
Computer ne demande votre approbation que lorsqu’un identifiant personnel ou de projet enregistré est réglé sur Demander une approbation. Les nouveaux identifiants sont réglés sur Toujours autoriser, mais ceux enregistrés avant l’introduction de ce réglage par défaut conservent leur réglage actuel. Pour ne plus recevoir de demandes pour un identifiant, sélectionnez Toujours autoriser dans les paramètres de cet identifiant dans votre coffre-fort d’identifiants.
Comment réutiliser un identifiant dans une tâche future ?
Enregistrez-le dans votre coffre-fort d’identifiants lorsque Computer vous y invite, ou ajoutez-le directement depuis le coffre-fort. Lors des tâches ultérieures, Computer le reconnaît et l’utilise, ou vous demande d’abord votre accord si l’identifiant est réglé sur Demander une approbation.
Où trouver mon coffre-fort d’identifiants ?
Accédez à Paramètres > Coffre-fort d’identifiants. Si Plugins apparaît dans la barre latérale, vous pourrez peut-être aussi l’ouvrir depuis cet endroit : sélectionnez Ajouter un élément personnalisé, puis Connectez votre propre API. Cette option n’apparaît que si votre forfait et les paramètres de votre organisation autorisent les connecteurs personnalisés.
Mes collègues peuvent-ils utiliser mes clés ?
Oui, si vous les ajoutez en tant qu’identifiants du projet. Les identifiants personnels sont privés et associés à votre compte. Les identifiants du projet peuvent être utilisés par tous les membres du projet, et vous devez au minimum être rédacteur sur le projet pour les ajouter ou les révoquer.
Puis-je stocker d’autres secrets, comme une clé SSH ?
Non. Les identifiants personnalisés prennent en charge les requêtes API acheminées via le proxy sécurisé. D’autres formats de secrets, tels que les clés SSH, ne sont pas pris en charge à ce jour.
Le nom d’utilisateur et le mot de passe sont-ils les mêmes que ceux utilisés pour me connecter au site web de ce service ?
Non. Lorsque vous fournissez un nom d’utilisateur et un mot de passe, Computer les enregistre en tant qu’identifiant Basic auth afin de s’authentifier auprès de l’API du service ; il ne s’agit pas d’une connexion générale permettant de se connecter au site web de ce service. Les identifiants personnalisés servent uniquement à authentifier les requêtes API, à l’aide de jetons, d’en-têtes personnalisés, de paramètres de requête ou de Basic auth. Si vous ne savez pas quelle valeur saisir, consultez la documentation de l’API pour savoir comment elle attend que les requêtes soient authentifiées.
Articles connexes
Besoin d’aide supplémentaire ?
Contactez-nous via Help > Contact Support. Indiquez le lien de la tâche si votre question porte sur une tâche Computer précise.