Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
O Azure SRE Agent é mais eficaz quando pode usar o mesmo contexto que a sua equipa usa para resolver problemas nos sistemas. Ligue runbooks, documentação, páginas na Web e repositórios para que o seu agente possa consultá-los durante as investigações, em vez de partir do zero.
Sugestão
- Use a Builder > base de conhecimento para gerir ficheiros, páginas web e repositórios num só lugar.
- O conhecimento indexado está automaticamente disponível durante as investigações e o chat.
- Pode carregar documentos diretamente, anexar ficheiros no chat ou ligar repositórios para uma análise consciente da fonte.
- As fontes de conhecimento mais úteis são aquelas das quais a tua equipa já depende, como runbooks, notas de arquitetura, guias de resolução de problemas e código-fonte.
Por que o conhecimento importa
O seu agente já tem contexto Azure incorporado através de ferramentas de observabilidade e sistemas ligados. O que não tem, por defeito, é o conhecimento interno da sua equipa. Esse conhecimento inclui o runbook que explica um passo comum de recuperação, a nota de arquitetura que identifica uma dependência partilhada, ou o repositório que revela qual a implementação que introduziu uma regressão.
Quando liga essa base de conhecimento, o seu agente pode:
- Consulte os guias operacionais da equipa durante um incidente.
- Reutilize passos de resolução de problemas que a sua equipa já tenha documentado.
- Correlaciona os sintomas com o código-fonte e o contexto de implementação.
- Responda às perguntas usando os mesmos documentos e referências que os humanos utilizam.
Gerir o conhecimento na base de conhecimento
Utilize a Base de conhecimento do Builder > para gerir as fontes de conhecimento do seu agente.
A página mostra cada fonte com as suas:
- Nome
- Status
- Type
- Data da última modificação
Estão disponíveis três tipos de fonte:
| Tipo de fonte | O que oferece | Como adicionar |
|---|---|---|
| Files | Procedimentos operacionais, guias de resolução de problemas, documentos de arquitetura e material de referência | Faça o upload através do portal ou peça ao agente para guardar um documento durante o chat |
| Páginas Web | Documentação externa, URLs internas da wiki e páginas de estado | Adicione o URL da página para que o agente possa indexar o conteúdo |
| Repositórios | Código-fonte, ficheiros de implementação e definições de infraestrutura | Ligar os repositórios do GitHub ou do Azure DevOps |
Verificar o estado e a frescura da indexação
Cada fonte de conhecimento apresenta um dos seguintes estados:
| Situação | Meaning |
|---|---|
| Indexado | O conteúdo é processado e pesquisável |
| pendente | O conteúdo ainda está a ser processado |
| Não indexado | O processamento falhou ou a fonte não pôde ser indexada |
Quando uma fonte é indexada, passe o rato sobre o indicador de estado para ver a data e hora de Criação. Este carimbo temporal é útil quando se quer confirmar que a versão mais recente de um runbook ou documento está a ser processada.
Carregar documentos
Carregue documentos quando quiser que o conhecimento continue disponível em futuras conversas.
Exemplos típicos incluem:
- Guias de Procedimentos para Incidentes
- Guias de escalada
- Referências arquitetónicas
- Listas de verificação de resolução de problemas
Pode carregar ficheiros através do portal, ou pode pedir ao agente para guardar o conteúdo de uma conversa na base de conhecimento.
Para formatos de ficheiro suportados e limites, consulte Carregar documentos de conhecimento.
Para o fluxo de trabalho completo, consulte Carregar documentos de conhecimento.
Partilhar ficheiros no chat
Use anexos de chat quando quiser dar contexto imediato ao agente numa única conversa. Esta abordagem é útil para capturas de ecrã, registos, ficheiros de configuração e outros materiais que ajudam na resolução ativa de problemas.
Sugestão
Se um ficheiro que anexar no chat se tornar conhecimento a longo prazo, peça ao agente para o guardar nas definições de Conhecimento. O agente pode carregar uma cópia para que o conteúdo fique indexado e pesquisável em conversas posteriores.
A tabela seguinte compara os carregamentos de conhecimento a longo prazo com anexos temporários de chat:
| Scenario | Carregar para a Base de Conhecimento | Partilhar no chat |
|---|---|---|
| Melhor para | Guias operacionais, procedimentos e documentos que pretende ter disponíveis em conversas futuras | Ficheiros que queres que o agente analise agora mesmo |
| Âmbito de armazenamento | Nível de agente e pesquisável em conversas futuras | Ao nível do tópico e disponível na conversa atual |
| Como adicionar | Carregue no portal ou peça ao agente para guardar o conteúdo | Arrastar e soltar, colar a partir da prancheta ou usar + no chat |
| Pode tornar-se conhecimento a longo prazo | Conhecimento já de longo prazo | Sim, se pedir ao agente para o guardar |
Para mais informações, consulte Partilhar ficheiros no chat.
Adicionar páginas web
Adicione páginas web quando a orientação importante estiver fora dos ficheiros ou repositórios carregados.
Os bons candidatos incluem:
- Artigos internos da wiki
- Documentação pública do produto
- Páginas de estado do serviço
- Páginas de referência mantidas pela equipa
Depois de adicionar um URL, o agente indexa o conteúdo da página para poder referenciar essa informação durante investigações futuras.
Liga repositórios
Ligue repositórios do GitHub ou do Azure DevOps se o seu agente precisar de contexto com reconhecimento da origem.
Repositórios ligados ajudam o agente:
- Pesquisa por padrões de erro no código-fonte
- Correlacionar incidentes com alterações recentes ao código
- Ficheiros de implementação e configuração de referência
- Utilizar o conteúdo do repositório durante a análise da causa raiz
Para ligar código-fonte, consulte Conectar código-fonte.
Escolha a fonte de conhecimento certa
Usa o tipo de fonte que corresponde ao tipo de contexto que precisas:
| Se precisares de estabelecer ligação... | Utiliza... |
|---|---|
| Um manual de procedimentos ou guia de resolução de problemas armazenado num ficheiro | Carregar documentos de conhecimento |
| Uma captura de ecrã, registo ou ficheiro para uma investigação ativa | Partilhar ficheiros no chat |
| Um repositório GitHub ou Azure DevOps | Liga o código-fonte |
| Sistemas externos como Datadog ou Splunk | Conectores MCP |