Simple Log Service:SLS DataAgent (anciennement Intelligent Q&A Assistant)

1. Connectez-vous à la console Log Service.

2. Choisissez Log Apps > SLS DataAgent, puis cliquez sur Digital Employee.

3. Sur la page de l'employé numérique, cliquez sur Create Digital Employee dans le coin supérieur droit.

4. Dans la boîte de dialogue Create Digital Employee, configurez les paramètres suivants :

   Paramètre	Obligatoire	Description
   ID	Oui	Identifiant unique de l'employé numérique. Cet ID ne peut pas être modifié après sa création. Nous recommandons d'utiliser une combinaison de lettres et de chiffres, par exemple order-system-expert.
   Nom d'affichage	Oui	Nom affiché pour l'employé numérique dans l'interface utilisateur. Nous recommandons d'utiliser un nom qui reflète son objectif métier, tel que « Expert de surveillance du système de commandes » ou « Inspecteur de cluster Big Data ».
   Type de rôle RAM	Oui	Spécifie le type de rôle RAM pour l'employé numérique. Vous pouvez sélectionner l'une des options suivantes : • Rôle de service : utilisez le rôle de service fourni par le système (aucune configuration requise). L'employé numérique obtient automatiquement les permissions de lecture pour Log Service et ARMS. • Rôle personnalisé : sélectionnez cette option si vous devez accéder à une base de connaissances Model Studio spécifique ou restreindre la portée d'accès. Vous devez configurer un ARN de rôle RAM autorisé. Pour plus d'informations, consultez la section Créer et autoriser un rôle RAM.
   ARN du rôle RAM	Oui	Ce paramètre est requis uniquement si vous sélectionnez un rôle personnalisé. Le rôle de service par défaut utilise le rôle ServiceRoleForCloudMonitor, qui dispose des permissions de lecture pour Cloud Monitor, Log Service (SLS) et ARMS.
   Base de connaissances SLS intégrée	Non	Si cette option est activée, l'employé numérique répond aux questions liées à SLS. Elle est activée par défaut.
   Description	Non	Décrivez les responsabilités et les capacités de l'employé numérique. Par exemple : « Responsable des inspections quotidiennes, de l'analyse des anomalies et de l'analyse des causes profondes pour les applications centrales du centre de commandes. Capable d'analyser les requêtes MySQL lentes. »
   Règles par défaut	Non	Règles par défaut pour guider le comportement de l'employé numérique. Nous recommandons d'utiliser la syntaxe Markdown. Vous pouvez définir le rôle de l'employé, la portée de ses capacités et les directives comportementales.

5. Une fois les paramètres configurés, cliquez sur OK.

Structure de la base de connaissances SOP

La base de connaissances SOP utilise une structure modulaire basée sur des répertoires, avec le fichier SOP.md comme point d'entrée principal. Cette architecture permet à l'agent de localiser de manière autonome les informations requises.

Voici une structure de répertoire recommandée : accesslog_sop .zip

knowledge_base_root/
├── SOP.md                  # Core entry file, describes the overview of each knowledge domain
├── accesslog/              # Access log domain
│   ├── overview.md         # Domain overview
│   └── troubleshooting.md  # Troubleshooting guide
├── monitoring/             # Monitoring domain
│   ├── overview.md
│   └── alert-handling.md
└── ...

Dans le fichier SOP.md, présentez une vue d'ensemble de chaque domaine de connaissance, puis fournissez les détails dans les fichiers correspondants au sein de chaque répertoire.

Associer la base de connaissances SLS intégrée

La base de connaissances SLS intégrée contient les procédures opérationnelles standard et les meilleures pratiques pour Log Service, ce qui facilite la réponse aux questions liées à SLS.

Méthode 1 : Activation lors de la création

Lors de la création de l'employé numérique, maintenez l'option Built-in SLS knowledge base activée.

Méthode 2 : Ajout après la création

1. Dans la liste des employés numériques, cliquez sur l'employé numérique cible pour ouvrir sa page de détails.

2. Sélectionnez l'onglet Knowledge base.

3. Cliquez sur Add Knowledge Base et sélectionnez le type Built-in knowledge base.

4. Dans le champ Knowledge base ID, saisissez sls et cliquez sur OK.

Associer une base de connaissances OSS

Si vos documents SOP sont stockés dans OSS, suivez ces étapes pour associer une base de connaissances OSS.

Prérequis

• Vous avez créé un compartiment OSS et y avez téléchargé vos documents SOP.

• Vous avez créé et configuré un rôle RAM personnalisé. Pour plus de détails, consultez la section Créer et autoriser un rôle RAM.

Procédure

1. Modifiez le type de rôle RAM de l'employé numérique en Custom role et configurez l'ARN du rôle RAM autorisé.

2. Sur la page de détails de l'employé numérique, sélectionnez l'onglet Knowledge base.

3. Cliquez sur Add Knowledge Base et sélectionnez le type OSS knowledge base.

4. Configurez les paramètres suivants :

   Parameter	Description
   OSS region	Région où se trouve le compartiment OSS contenant les documents SOP.
   OSS bucket	Nom du compartiment OSS.
   Document library root path	Chemin du répertoire où se trouve le fichier SOP.md. Si SOP.md se trouve dans le répertoire racine du compartiment, saisissez /. S'il se trouve dans un sous-répertoire, indiquez le chemin complet, par exemple /docs/sop/.

5. Cliquez sur OK.

Associer une base de connaissances Apsara Devops

Si vous utilisez Apsara Devops (Codeup) pour gérer vos documents SOP, suivez ces étapes pour associer une base de connaissances Apsara Devops.

Prérequis

• Vous avez créé un dépôt de code dans la console Apsara Devops et y avez téléchargé vos documents SOP.

• Vous avez généré un jeton d'accès personnel.

Obtenir les informations de configuration

1. Organization ID : Vous pouvez trouver l'ID de l'organisation dans l'URL de la page. L'URL est au format https://codeup.aliyun.com/<Organization_ID>/<Repository_Name>\.

2. Repository ID : Sur la page du dépôt de code, choisissez Settings > Basic Information pour afficher l'ID.

3. Personal access token :

   • Dans la console Apsara Devops, cliquez sur votre photo de profil en haut à droite et sélectionnez Personal settings.

   • Choisissez Personal access tokens et cliquez sur Create Access Token.

   • Définissez un nom, une date d'expiration et une étendue d'autorisation pour le jeton, puis cliquez sur Create.

   • Copiez le jeton généré et conservez-le en lieu sûr. Le jeton n'est affiché qu'une seule fois.

Procédure

1. Sur la page de détails de l'employé numérique, sélectionnez l'onglet Knowledge base.

2. Cliquez sur Add Knowledge Base et sélectionnez le type Apsara Devops knowledge base.

3. Configurez les paramètres suivants :

   Parameter	Description
   Organization ID	ID de votre organisation Apsara Devops.
   Repository ID	ID de votre dépôt de code.
   Branch name	Branche à associer, telle que master ou main.
   Personal access token	Votre jeton d'accès personnel Apsara Devops.
   Document library root path	Chemin du répertoire où se trouve le fichier SOP.md.

4. Cliquez sur OK.

Accorder des permissions à un utilisateur RAM

Pour utiliser SLS DataAgent en tant qu'utilisateur RAM, un administrateur doit d'abord vous accorder les permissions nécessaires.

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "ram:PassRole",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "acs:Service": "cloudmonitor.aliyuncs.com"
        }
      }
    }
  ]
}

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "cms:CreateChat",
        "cms:CreateThread",
        "cms:GetThread",
        "cms:GetThreadData",
        "cms:ListThreads"
      ],
      "Resource": "acs:cms:*:*:digitalEmployee/*"
    }
  ]
}

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "cms:CreateChat",
        "cms:GetDigitalEmployee",
        "cms:ListDigitalEmployees",
        "cms:GetThread",
        "cms:GetThreadData",
        "cms:ListThreads",
        "cms:CreateDigitalEmployee",
        "cms:UpdateDigitalEmployee",
        "cms:DeleteDigitalEmployee",
        "cms:CreateThread",
        "cms:UpdateThread",
        "cms:DeleteThread"
      ],
      "Resource": [
        "acs:cms:*:*:digitalemployee/*",
        "acs:cms:*:*:digitalemployee/*/thread/*"
      ]
    }
  ]
}

Créer et autoriser un rôle RAM

Si vous devez utiliser un rôle personnalisé, par exemple pour accéder à une base de connaissances OSS, suivez ces étapes pour créer et autoriser un rôle RAM.

Étape 1 : Créer un rôle RAM

1. Connectez-vous à la console RAM.

2. Dans le volet de navigation de gauche, choisissez Identities > Roles.

3. Cliquez sur Create Role et sélectionnez Alibaba Cloud Service comme type d'entité de confiance.

4. Configurez les informations suivantes :

   • Role name : saisissez un nom personnalisé pour le rôle.

   • Select trusted service : sélectionnez CloudMonitor/Cms.

5. Cliquez sur Complete.

Étape 2 : Autoriser le rôle RAM

1. Créez une stratégie de permissions personnalisée. La stratégie suivante accorde des permissions de lecture pour OSS et Log Service :

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "oss:GetObject",
        "oss:GetObjectAcl",
        "oss:ListObjects",
        "oss:ListObjectVersions"
      ],
      "Resource": [
        "acs:oss:*:*:<OSS_BUCKET_NAME>",
        "acs:oss:*:*:<OSS_BUCKET_NAME>/*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "log:Get*",
        "log:List*"
      ],
      "Resource": "*"
    }
  ]
}

Note : Remplacez <OSS_BUCKET_NAME> par le nom réel de votre bucket OSS.

2. Attachez la stratégie de permissions personnalisée que vous avez créée au rôle RAM.