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

1. Faça login 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 usar um nome que reflita seu propósito de negócio, como "Especialista em Monitoramento 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 serviço 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 configurar um ARN de função RAM autorizado. Para mais informações, consulte Criar e autorizar uma função RAM.
   RAM role ARN	Sim	Este parâmetro é obrigatório apenas se você selecionar uma função personalizada. A função de serviço padrão utiliza a função ServiceRoleForCloudMonitor, que possui permissões de leitura para CloudMonitor, 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. Você pode definir a função do funcionário, o escopo de capacidades e as diretrizes comportamentais.

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

Estrutura da base de conhecimento SOP

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

A seguir, apresentamos 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: Ativar 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 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 do OSS

Caso seus documentos SOP estejam armazenados no OSS, siga estas etapas para associar uma base de conhecimento do OSS.

Pré-requisitos

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

• Você criou e configurou uma função RAM personalizada. Para detalhes, consulte Criar e autorizar uma função RAM.

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	Região onde está localizado o bucket do OSS que armazena os documentos SOP.
   OSS bucket	Nome do bucket do OSS.
   Document library root path	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 do Alibaba Cloud DevOps

Se você utiliza o Alibaba Cloud DevOps (Codeup) para gerenciar seus documentos SOP, siga estas etapas para associar uma base de conhecimento do Alibaba Cloud DevOps.

Pré-requisitos

• Você criou um repositório de código no console do Alibaba Cloud 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 visualizar o ID.

3. Personal access token:

   • No console do Alibaba Cloud DevOps, clique 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 com segurança o token gerado. 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 Alibaba Cloud DevOps knowledge base.

3. Configure os seguintes parâmetros:

   Parâmetro	Descrição
   Organization ID	ID da sua organização no Alibaba Cloud DevOps.
   Repository ID	ID do seu repositório de código.
   Branch name	Branch a ser associada, como master ou main.
   Personal access token	Seu token de acesso pessoal do Alibaba Cloud DevOps.
   Document library root path	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 usuário RAM, um administrador deve primeiro conceder as permissões necessárias.

{
  "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 do OSS, siga estas etapas para criar e autorizar uma função RAM.

Etapa 1: Criar uma função RAM

1. Faça login no console do 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 a seguir 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 do OSS.

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