Remove clickable hyperlink from agent endpoint and redirect to invocation docs#6695
Open
Remove clickable hyperlink from agent endpoint and redirect to invocation docs#6695
Conversation
Copilot
AI
changed the title
[WIP] Remove hyperlink for agent endpoint and add redirect to documentation
Remove clickable hyperlink from agent endpoint and redirect to invocation docs
Feb 3, 2026
…note - Update artifact.go to only use hyperlinks for endpoints with LocationKind=Remote - Add support for 'note' metadata field in artifact rendering - Set agent endpoint LocationKind to UNSPECIFIED to make it non-clickable - Add note pointing to aka.ms/azd-agents-invoke for agent invocation docs Fixes #6659
rajeshkamal5050
force-pushed
the
copilot/remove-hyperlink-agent-endpoint
branch
from
3ad59d3 to
1e88cc7
Compare
rajeshkamal5050
requested review from
hemarina,
vhvb1989 and
wbreza
as code owners
rajeshkamal5050
requested review from
JeffreyCA,
tg-msft,
trangevi and
weikanglim
as code owners
Contributor
There was a problem hiding this comment.
Pull request overview
This PR attempts to address user confusion when clicking on agent endpoints after deployment, which results in 401 errors. The goal is to remove the clickable hyperlink from agent endpoints and add a documentation reference to guide users on proper agent invocation.
Changes:
- Modified endpoint artifact display logic to conditionally make endpoints clickable based on LocationKind
- Added support for displaying note metadata beneath endpoint artifacts
- Changed agent endpoint LocationKind from REMOTE to UNSPECIFIED to prevent hyperlinking
- Added documentation URL as note metadata for agent endpoints
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 5 comments.
| File | Description |
|---|---|
| cli/azd/pkg/project/artifact.go | Added conditional hyperlinking based on LocationKind and note metadata display support |
| cli/azd/extensions/azure.ai.agents/internal/project/service_target_agent.go | Changed agent endpoint LocationKind to UNSPECIFIED and added documentation URL in note metadata |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
cli/azd/extensions/azure.ai.agents/internal/project/service_target_agent.go
Outdated
Show resolved
Hide resolved
cli/azd/extensions/azure.ai.agents/internal/project/service_target_agent.go
Outdated
Show resolved
Hide resolved
| "agentName": agentName, | ||
| "agentVersion": agentVersion, | ||
| "label": "Agent endpoint", | ||
| "note": "For consuming agent endpoint, refer to https://aka.ms/azd-agents-invoke", |
There was a problem hiding this comment.
The PR description references the full Microsoft Learn documentation URL (https://learn.microsoft.com/en-us/azure/ai-foundry/agents/concepts/hosted-agents?view=foundry#invoke-hosted-agents), but the implementation uses a short URL (https://aka.ms/azd-agents-invoke). While using a short URL may be intentional for better user experience, it's unclear whether this aka.ms link is configured to redirect to the correct destination specified in the issue.
Contributor
There was a problem hiding this comment.
@rajeshkamal5050 this aka.ms link doesn't exist - is this the right link?
Contributor
There was a problem hiding this comment.
@tinaem can you help with create an aka.ms like for this - https://aka.ms/azd-agents-invoke pointing to https://learn.microsoft.com/en-us/azure/ai-foundry/agents/concepts/hosted-agents?view=foundry#invoke-hosted-agents so we can use it?
Collaborator
Azure Dev CLI Install InstructionsInstall scriptsMacOS/Linux
bash: pwsh: WindowsPowerShell install MSI install Standalone Binary
MSI
Documentationlearn.microsoft.com documentationtitle: Azure Developer CLI reference
|
JeffreyCA
approved these changes
Feb 3, 2026
Contributor
LGTM thanks @JeffreyCA |
rajeshkamal5050
approved these changes
Feb 3, 2026
hemarina
approved these changes
Feb 4, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Users were clicking the agent endpoint URL after deployment and receiving 401 errors. The endpoint requires proper authentication via SDK/API calls, not direct browser access.
Changes
Modified artifact display for agent endpoints (
pkg/project/artifact.go)"Agent endpoint"Added unit tests (
pkg/project/artifact_test.go)Output
Before:
After:
Original prompt
✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.