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

1. Faça logon no console do Log Service.

2. Escolha Log Apps > SLS DataAgent e clique em Digital Employee.

3. Na página do funcionário digital, clique em Create Digital Employee no canto superior direito.

4. Na caixa de diálogo Create Digital Employee, configure os seguintes parâmetros:

   Parâmetro	Obrigatório	Descrição
   ID	Sim	Identificador exclusivo do funcionário digital. Este ID não pode ser alterado após a criação. Recomendamos usar uma combinação de letras e números, como order-system-expert.
   Display name	Sim	Nome exibido para o funcionário digital na interface. Recomendamos utilizar um nome que reflita seu propósito de negócio, como "Especialista em Monitoramento do Sistema de Pedidos" ou "Inspetor de Cluster Big Data".
   RAM role type	Sim	Define o tipo de função RAM para o funcionário digital. Selecione uma das opções abaixo: • service role: Utiliza a função de service fornecida pelo sistema (sem necessidade de configuração). O funcionário digital obtém automaticamente permissões de leitura para Log Service e ARMS. • custom role: Escolha esta opção se precisar acessar uma base de conhecimento específica do Model Studio ou restringir o escopo de acesso. É necessário configure um ARN de função RAM autorizado. Para mais informações, consulte Create and authorize a RAM role.
   RAM role ARN	Sim	Este parâmetro é obrigatório apenas se você selecione uma função personalizada. A função de service padrão utiliza a função ServiceRoleForCloudMonitor, que possui permissões de leitura para Cloud Monitor, Log Service (SLS) e ARMS.
   Built-in SLS knowledge base	Não	Se ativado, o funcionário digital responde a perguntas relacionadas ao SLS. Esta opção vem habilitada por padrão.
   Description	Não	Descreva as responsabilidades e capacidades do funcionário digital. Por exemplo: "Responsável pela inspeção diária, análise de anomalias e análise de causa raiz para aplicações principais no centro de pedidos. Capaz de analisar consultas lentas do MySQL."
   Default rules	Não	Regras padrão para orientar o comportamento do funcionário digital. Recomendamos o uso da sintaxe Markdown. Defina aqui a função do funcionário, o escopo de capacidades e as diretrizes comportamentais.

5. Após configure os parâmetros, clique em OK.

Estrutura da base de conhecimento SOP

A base de conhecimento SOP adota uma estrutura modular baseada em diretórios, tendo o SOP.md como arquivo de entrada principal. Essa organização permite que o agente encontre autonomamente as informações necessárias.

Veja a seguir uma estrutura de diretórios recomendada: 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
└── ...

No arquivo SOP.md, forneça uma visão geral de cada domínio de conhecimento e, em seguida, detalhe as informações nos arquivos correspondentes dentro de cada diretório.

Associar a base de conhecimento integrada do SLS

A base de conhecimento integrada do SLS contém procedimentos operacionais padrão e melhores práticas para o Log Service, facilitando respostas a perguntas relacionadas ao SLS.

Método 1: Habilitar durante a criação

Ao criar o funcionário digital, mantenha a chave Built-in SLS knowledge base ativada.

Método 2: Adicionar após a criação

1. Na lista de funcionários digitais, clique em no funcionário desejado para abrir sua página de detalhes.

2. Selecione a aba Knowledge base.

3. Clique em Add Knowledge Base e selecione o tipo Built-in knowledge base.

4. No campo Knowledge base ID, insira sls e clique em OK.

Associar uma base de conhecimento OSS

Se seus documentos SOP estiverem armazenados no OSS, siga estas etapas para associar uma base de conhecimento OSS.

Pré-requisitos

• Você criou um bucket OSS e carregou seus documentos SOP.

• Você criou e configurou uma função RAM personalizada. Para detalhes, consulte Create and authorize a RAM role.

Procedimento

1. Altere o tipo de função RAM do funcionário digital para Custom role e configure o ARN da função RAM autorizada.

2. Na página de detalhes do funcionário digital, selecione a aba Knowledge base.

3. Clique em Add Knowledge Base e selecione o tipo OSS knowledge base.

4. Configure os seguintes parâmetros:

   Parâmetro	Descrição
   OSS region	A região onde está localizado o bucket OSS que armazena os documentos SOP.
   OSS bucket	O nome do bucket OSS.
   Document library root path	O caminho do diretório onde o arquivo SOP.md está localizado. Se o SOP.md estiver no diretório raiz do bucket, insira /. Se estiver em um subdiretório, insira o caminho completo, como /docs/sop/.

5. Clique em OK.

Associar uma base de conhecimento Apsara Devops

Caso utilize o Apsara Devops (Codeup) para gerencie seus documentos SOP, siga estas etapas para associar uma base de conhecimento Apsara Devops.

Pré-requisitos

• Você criou um repositório de código no console do Apsara Devops e carregou seus documentos SOP.

• Você criou um token de acesso pessoal.

Obter informações de configuração

1. Organization ID: Encontre o ID da organização na URL da página. A URL segue o formato https://codeup.aliyun.com/<Organization_ID>/<Repository_Name>\.

2. Repository ID: Na página do repositório de código, escolha Settings > Basic Information para visualize o ID.

3. Personal access token:

   • No console do Apsara Devops, clique em na sua foto de perfil no canto superior direito e selecione Personal settings.

   • Escolha Personal access tokens e clique em Create Access Token.

   • Defina um nome, data de expiração e escopo de permissão para o token e clique em Create.

   • Copie e salve o token gerado em um local seguro. O token é exibido apenas uma vez.

Procedimento

1. Na página de detalhes do funcionário digital, selecione a aba Knowledge base.

2. Clique em Add Knowledge Base e selecione o tipo Apsara Devops knowledge base.

3. Configure os seguintes parâmetros:

   Parâmetro	Descrição
   Organization ID	O ID da sua organização no Apsara Devops.
   Repository ID	O ID do seu repositório de código.
   Branch name	A branch a ser associada, como master ou main.
   Personal access token	Seu token de acesso pessoal do Apsara Devops.
   Document library root path	O caminho do diretório onde o arquivo SOP.md está localizado.

4. Clique em OK.

Conceder permissões a um usuário RAM

Para usar o SLS DataAgent como um usuário RAM, um administrador deve primeiro conceder as permissões necessárias a você.

{
  "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/*"
      ]
    }
  ]
}

Criar e autorizar uma função RAM

Se precisar usar uma função personalizada, por exemplo, para acessar uma base de conhecimento OSS, siga estas etapas para crie e autorizar uma função RAM.

Etapa 1: Criar uma função RAM

1. Faça logon no console RAM.

2. No painel de navegação à esquerda, escolha Identities > Roles.

3. Clique em Create Role e selecione Alibaba Cloud Service como o tipo de entidade confiável.

4. Configure as seguintes informações:

   • Role name: Insira um nome personalizado para a função.

   • Select trusted service: Selecione CloudMonitor/Cms.

5. Clique em Complete.

Etapa 2: Autorizar a função RAM

1. Crie uma política de permissão personalizada. A política abaixo concede permissões de leitura para OSS e 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": "*"
    }
  ]
}

Nota : Substitua <OSS_BUCKET_NAME> pelo nome real do seu bucket OSS.

2. Anexe a política de permissão personalizada criada à função RAM.