Cloud Exchange inclut un ensemble de fonctionnalités d’IA qui vous aident à configurer et à exploiter la plateforme. Ces fonctionnalités peuvent recommander des plugins et des valeurs de champ pendant que vous configurez un module, mapper les champs d’un plugin sur votre schéma Risk Exchange et lire les journaux de votre plateforme pour expliquer ce qui s’est mal passé et ce qu’il faut faire à ce sujet.
Important
- Les fonctionnalités d'IA nécessitent un plugin de fournisseur LLM configuré et activé. En savoir plus.
- Tous les résultats produits par les fonctionnalités IA sont des suggestions que vous devez examiner et appliquer en conséquence. L’IA elle-même n’apportera aucune modification à Cloud Exchange. Le temps de réponse de l’IA peut varier en fonction de la complexité de la question.
Fonctionnalités d'IA dans Cloud Exchange
| Fonction | Où vous l'utilisez | Ce que ça fait |
|---|---|---|
| AI Copilot | L’icône Copilot, disponible sur chaque page de Cloud Exchange | Répond aux questions sur la page sur laquelle vous vous trouvez, vous guide étape par étape dans une configuration. Il soulève également des alertes proactives qui nécessitent votre attention en effectuant une détection programmée basée sur des règles prédéfinies. |
| CRE Auto-Mapper | Assistant de configuration du plugin Risk Exchange | Suggère un champ de plateforme de destination pour chaque champ d'une entité de plugin et propose de New champs lorsqu'aucun champ approprié n'existe. |
| Évaluation de la posture | Settings > Logging | Analyse un journal de plateforme unique ou un ensemble filtré de journaux et renvoie un verdict de santé avec un plan de remédiation hiérarchisé. |
Regardez une vidéo
Cliquer sur « play » pour regarder une vidéo.
Gérer les configurations du fournisseur
Users with ai-write and settings-write access can create the configuration.
Les utilisateurs disposant d’un accès ai-write peuvent modifier, activer/désactiver ou supprimer la configuration en utilisant les options disponibles sur la configuration créée en sélectionnant l’icône de modification (crayon), l’icône de désactivation (cercle barré) ou l’icône de suppression (corbeille).
La désactivation du fournisseur ou la suppression de la dernière configuration de fournisseur désactive toutes les fonctionnalités d’IA. Cloud Exchange continue de fonctionner normalement sans fonctionnalités d’IA. Le chat Copilot indique qu’aucun fournisseur d’IA n’est configuré, les actions d’évaluation de la posture sont indisponibles et l’assistant de configuration du plugin Risk Exchange renvoie une erreur pour l’action de mappage automatique jusqu’à ce qu’un fournisseur d’IA soit activé.
Autorisations des fonctionnalités d'IA
L’accès aux fonctionnalités d’IA nécessite deux autorisations : ai-read ou ai-write sur le rôle de l’utilisateur et l’autorisation pour le module où la fonctionnalité s’exécute. Les administrateurs disposent d’un accès complet à toutes les fonctionnalités d’IA.
| Permission | Grants |
|---|---|
| Copilote IA > Lecture | Utilisez l’assistant IA, exécutez une évaluation de posture ou une analyse de journal unique, et consultez le tableau de bord AI Analytics. |
| Copilote IA > Écriture & Paramètres > Écriture | Configurez le fournisseur LLM et toutes les autorisations octroyées par l’accès en lecture de l’IA Copilot. |
| Risk Exchange > Écrire | Utilisez le mappage automatique CRE. Le mappage automatique fait partie de la configuration du plugin Risk Exchange, il ne nécessite donc aucune autorisation AI Copilot supplémentaire, à l’exception d’un plugin de fournisseur LLM configuré. |
Le copilote ne renvoie jamais de données qu'un utilisateur n'est pas autorisé à voir. Il ne lit que les modules sur lesquels l'utilisateur connecté dispose d'une autorisation de lecture. Si une étape de configuration guidée nécessite l'accès à une page à laquelle l'utilisateur ne peut pas accéder, l'action est bloquée et la raison s'affiche. Pour plus de détails sur l'attribution des autorisations, accédez à Utilisateurs de Cloud Exchange.
Ce que Cloud Exchange envoie au fournisseur LLM
Les fonctionnalités d'IA n'envoient que ce qui est nécessaire pour répondre à la demande, et les champs secrets sont supprimés avant que la demande ne quitte votre déploiement.
- Credentials are never sent. Les paramètres de configuration du plugin sont dépouillés de tout mot de passe, jeton, clé API et secret avant d’atteindre le modèle. Le copilote peut vous indiquer quel champ remplir, mais il ne voit jamais et ne répète jamais la valeur.
- Records are never sent. Le mappage automatique CRE lit votre schéma, pas vos données. Aucune valeur d'enregistrement d'utilisateur, de périphérique ou d'application n'est incluse dans une demande de mappage automatique.
- Log content is sent only when you ask for it. L’évaluation de la posture et l’analyse des logs uniques envoient les logs que vous avez sélectionnés. Les alertes proactives sont purement basées sur des règles prédéfinies. Il ne fait appel à aucun plugin de fournisseur LLM ; cependant, il peut être utilisé si vous demandez de l’aide pour corriger les résultats soulevés.
- Grounding is restricted. Lorsque le modèle sélectionné prend en charge la recherche Web, les fonctionnalités d'IA sont autorisées à rechercher dans la documentation du produit Netskope pour trouver leurs réponses, et chaque source est répertoriée sous Sources dans le résultat.
Affiner les fonctionnalités d'IA avec des variables d'environnement
Les fonctionnalités d'IA s'exécutent avec les paramètres par défaut qui conviennent à la plupart des déploiements. La modification de ces paramètres peut dégrader le temps de réponse ou la qualité de réponse de l'IA. Si vous devez modifier le niveau de détail renvoyé par le copilote, la charge de travail autorisée pour une seule demande d'IA ou le volume de vos journaux lu par une évaluation, définissez ces variables d'environnement sur le conteneur principal de Cloud Exchange. Chaque variable est facultative, et une valeur non définie ou non reconnue revient à la valeur par défaut indiquée.
| Variable | Default | Description |
|---|---|---|
AI_COPILOT_VERBOSITY | concise | Le degré de détail des réponses de Copilot. Accepte concise, balanced ou detailed (insensible à la casse). Toute valeur non reconnue revient à concise. |
AI_COPILOT_TURN_MAX_ITERATIONS | 30 | Nombre maximal d’étapes de raisonnement qu’un agent Copilot peut effectuer en un seul tour, appliqué à chaque agent. Accepte un nombre entier positif ; les valeurs inférieures à 1 sont portées à 1 et les valeurs non numériques sont ramenées à 30. Augmentez cette valeur si des demandes complexes sont interrompues. |
AI_COPILOT_MAX_LOG_CAP | 500 | Nombre maximal de lignes de journal cumulées que l’outil de tri peut extraire dans le contexte pour une analyse. Accepte un nombre entier positif ; les valeurs inférieures à 1 sont portées à 1 et les valeurs non numériques sont ramenées à 500. |
CE_ATTENTION_SCAN_DISABLED | false | Interrupteur d'arrêt pour l'analyse d'attention en arrière-plan qui fait apparaître les éléments nécessitant un examen. Accepte true pour désactiver ; toute autre valeur, y compris non définie, laisse activé. |
Suivre l'activité de l'IA avec Langfuse
Cloud Exchange peut envoyer des traces de son activité d’IA à Langfuse, une plateforme d’observabilité LLM open source. Les traces enregistrent les appels de modèle, les appels d’outil et le nombre de jetons derrière chaque tour de copilote et chaque évaluation, ce qui est utile lorsque vous souhaitez voir étape par étape comment une réponse a été produite, comparer le coût sur les fonctionnalités au fil du temps ou enquêter sur une demande lente.
Le suivi est entièrement facultatif et désactivé par défaut. Il ne change jamais ce que font les fonctionnalités d’IA ou ce qu’elles renvoient, et Cloud Exchange continue de fonctionner normalement si le point de terminaison Langfuse est inaccessible. Activez-le en définissant les variables ci-dessous ; le suivi s’active dès que les deux clés sont présentes. Consultez https://langfuse.com/docs pour la configuration de Langfuse et pour obtenir les clés.
| Variable | Default | Description |
|---|---|---|
LANGFUSE_PUBLIC_KEY | unset | Clé publique Langfuse. Requis pour activer le suivi. |
LANGFUSE_SECRET_KEY | unset | Clé secrète Langfuse. Requis pour activer le suivi. |
LANGFUSE_BASE_URL | unset | URL du point de terminaison Langfuse. Est prioritaire sur LANGFUSE_HOST lorsque les deux sont définis. |
LANGFUSE_HOST | unset | URL du point de terminaison Langfuse, utilisée uniquement lorsque LANGFUSE_BASE_URL n’est pas défini. |
LANGFUSE_TRACING_ENABLED | non défini — activé lorsque les deux clés sont présentes | Interrupteur principal. Accepte false ou 0 pour désactiver le traçage même lorsque les deux clés sont définies. Toute autre valeur laisse la règle de présence de clé en charge. |
Dépanner les fonctionnalités d'IA
| Symptom | Resolution |
|---|---|
| Le copilote indique qu’aucun fournisseur d’IA n’est configuré ou que le fournisseur d’IA est désactivé. | Accédez à Settings > LLM Provider et configurez un fournisseur, ou activez une configuration existante. |
| Une action IA échoue avec une erreur d'authentification. | La clé API est invalide, expirée ou a été révoquée par le fournisseur. Modifiez la configuration et entrez une New clé. |
| Une action d'IA échoue avec une erreur de limite de débit ou de service occupé. | Le fournisseur limite le débit ou est temporairement surchargé. Cloud Exchange effectue une nouvelle tentative automatiquement en fonction du fournisseur LLM ; réessayez l’action après une courte attente. |
| Une action IA échoue avec un message indiquant que la conversation ou la requête est trop longue. | Commencez une New discussion avec le copilote ou réduisez le filtre de journal avant d'exécuter une évaluation de la posture. Simplifiez une question complexe comportant plusieurs requêtes en une question avec une seule requête pour le copilote. |
L’activité IA est consignée dans les journaux de la plateforme avec le préfixe AI-COPILOT. Accédez à Settings > Logging et filtrez sur celle-ci pour voir ce qu’une requête ayant échoué a signalé.