Tutorial: Usar o DocsGuide no Agente SRE do Azure

Neste tutorial, use DocsGuide (a funcionalidade de documentação interna) para fazer perguntas ao agente sobre os recursos, a configuração e os conceitos do Agente SRE do Azure. O DocsGuide responde a partir da documentação oficial em tempo real, assim, as respostas são mantidas atualizadas conforme os recursos evoluem.

Tempo estimado: 5 minutos

Neste tutorial, você:

  • Faça uma pergunta de conceito e observe o cartão de resposta DocsGuide
  • Faça uma pergunta de instalação e receba diretrizes passo a passo
  • Fazer uma pergunta sobre a funcionalidade e examinar os detalhes da capacidade
  • Explorar diferentes padrões de pergunta que disparam DocsGuide

Pré-requisitos

Antes de começar, verifique se você tem os seguintes recursos:

  • Um agente SRE do Azure em estado de execução
  • Acesso à interface de chat do agente
  • Acesso de rede de saída para sre.azure.com (O DocsGuide busca páginas de documentação durante a execução)

Abrir o chat do agente

Comece acessando o portal do agente e abrindo uma conversa.

  1. Vá para sre.azure.com e selecione seu agente.
  2. A interface de chat se abre com a visualização Novo chat e um campo de entrada.

Captura de tela da interface de chat do agente mostrando a nova exibição de thread com a entrada de chat pronta.

Checkpoint: A entrada de chat é visível e mostra o espaço reservado "Faça uma pergunta ou insira uma barra(/) para usar um comando".

Fazer uma pergunta sobre um conceito

Tente fazer uma pergunta sobre um conceito do Agente SRE do Azure para ver como DocsGuide responde.

Digite a seguinte pergunta na entrada do chat:

What are run modes?

Aguarde cerca de 10 segundos pela resposta.

Captura de tela do cartão de agente personalizado do DocsGuide, mostrando a tarefa Definir modos de execução com uma marca de seleção verde dentro de um contêiner de Exploração paralela.

Checkpoint: Você vê:

  • Um cartão Exploração Paralela com "1 agente · 1 concluído"
  • Um cartão de agente personalizado do DocsGuide aninhado, com um ícone de pesquisa e uma marca de seleção verde
  • O cartão DocsGuide mostra sua tarefa (por exemplo, "Definir modos de execução")
  • Abaixo do cartão, a resposta sintetizada do agente sobre os modos de execução

Fazer uma pergunta de instalação

Em seguida, tente uma pergunta orientada à instalação para ver como o DocsGuide fornece diretrizes passo a passo.

Digite a seguinte pergunta:

How do I connect PagerDuty to my agent?

Checkpoint: A resposta inclui etapas de instalação específicas. Vá até Incidentes>Conecte uma plataforma de incidentes, selecione PagerDuty e siga o assistente de conexão. Depois, configure um plano de resposta em Incidentes>Gatilhos e planos de resposta.

Fazer uma pergunta sobre um recurso

Pergunte sobre uma funcionalidade específica para ver como o DocsGuide explica os recursos.

Digite a seguinte pergunta:

How do scheduled tasks work?

Checkpoint: A resposta explica a criação de tarefas agendadas, as opções de recorrência e como elas se conectam a agentes personalizados que são extraídos da funcionalidade de tarefas agendadas e das páginas do tutorial.

Tente perguntas sobre "Posso"

O padrão de pergunta "Posso..." também ativa o DocsGuide.

Digite a seguinte pergunta:

Can I use Python to extend my agent?

Checkpoint: DocsGuide retorna informações sobre ferramentas do Python, incluindo como criar e implantar ferramentas personalizadas do Python, originadas na documentação de execução de código do Python.

Dicas para perguntas efetivas

Use esses padrões de pergunta para obter as respostas mais precisas e completas do DocsGuide.

Tipo de pergunta Bom exemplo Exemplo menos eficaz
Recurso específico "Como faço para configurar planos de resposta a incidentes?" "Fale-me sobre o agente"
Etapas de instalação "Como faço para conectar meu conector Kusto?" "Configurar tudo"
Esclarecimento de conceito "Qual é a diferença entre habilidades e conhecimento?" "Explicar o agente"
Verificação de funcionalidade "Posso enviar notificações por meio do Teams?" "O que você pode fazer?"

Dica

Três padrões de pergunta funcionam melhor: "Como faço...", "Posso..."e "O que é...". Quanto mais específica for a pergunta, mais direcionada será a resposta.

Resumo

Neste tutorial, você aprendeu a:

  • Use o DocsGuide para fazer perguntas de documentação diretamente no chat do agente.
  • Faça perguntas sobre conceito, configuração e funcionalidades para obter respostas precisas e citadas.
  • Reconheça o cartão de tarefa do agente personalizado DocsGuide que mostra quais páginas de documentação foram consultadas.
  • Use padrões de pergunta específicos ("Como faço...", "Posso...", "O que é...") para obter os melhores resultados.

As respostas do DocsGuide vêm da documentação oficial do sre.azure.com, não dos dados de treinamento. A funcionalidade funciona da mesma maneira no chat do portal e no bot do Teams.

Próxima etapa