Skip to main content

Add a Web Page Knowledge Source

What you'll build

A web page knowledge source that your agent references during investigations. You'll add a public URL, verify it appears in the knowledge base, and confirm your agent can use the content. Learn more → Add Web Page Knowledge.

Prerequisites

  • An Azure SRE Agent in Running state
  • Write permissions on the agent (AgentMemoryWrite)
  • A publicly accessible web page URL to add (any page that loads in a browser without login)

Step 1: Open Knowledge Sources

  1. Go to sre.azure.com and select your agent
  2. In the left sidebar, select Builder
  3. Select Knowledge Sources

You'll see the Knowledge Sources page with three action cards at the top: Add file, Add web page, and Add repository.

Step 2: Open the Add Web Page dialog

Click the Add web page card (the one with the globe icon).

A dialog opens with three fields:

  • Web page URL (required) — the URL to fetch
  • Name (required) — a display name for this knowledge source
  • Description (optional) — a brief description of what the page contains

Step 3: Enter the web page details

Fill in the dialog:

  1. Web page URL — enter the full URL of the page you want to add. For example:
    https://learn.microsoft.com/en-us/azure/azure-monitor/overview
  2. Name — enter a descriptive name, such as Azure Monitor Overview
  3. Description — optionally describe the content, such as Official Azure Monitor documentation covering metrics, logs, and alerts
URL requirements

The URL must be:

  • An absolute URL (starting with http:// or https://)
  • Publicly accessible — no login, VPN, or SSO required
  • Reachable within 30 seconds

Step 4: Add the web page

Click the Add web page button.

The agent fetches the page content from the URL. If successful, you'll see a notification confirming the web page was added. The dialog closes automatically.

If the fetch fails, you'll see an error message. Common errors:

ErrorCauseFix
Invalid URL formatURL is not absolute or not HTTP/HTTPSUse a full URL starting with https://
HTTP request failed with status code 403Page blocks automated requestsTry a different page, or upload the content as a file instead
HTTP request failed with status code 404Page not foundCheck the URL for typos
Request timed outPage took longer than 30 seconds to respondTry again, or upload the content as a file
Network errorDNS or connectivity issueVerify the URL loads in your browser
The web page returned empty contentPage returned no contentThe page may require JavaScript to render — upload the content as a file instead

Step 5: Verify the knowledge source

After adding the web page, it appears in the Knowledge Sources list. You can verify:

  • Name — the display name you provided
  • Type — shows as Web page
  • Status — indicates whether the content was indexed

Step 6: Test with your agent

Now verify your agent can use the web page content:

  1. Navigate to Chats in the left sidebar
  2. Start a new conversation or open an existing one
  3. Ask a question related to the web page content. For example:
What does the Azure Monitor documentation say about log analytics workspaces?

Your agent should reference information from the web page you added in its response.

Updating web page content

Web page knowledge sources are point-in-time snapshots. If the source page is updated and you want your agent to have the latest content:

  1. Go to Builder → Knowledge Sources
  2. Select the web page entry
  3. Delete it
  4. Re-add the URL using the same steps above

Next steps

Was this page helpful?