Skip to content

[azure-ai-agents] Fix env var name mismatch, stale link, and grammar in README - #49002

Open
SIDDARTHA REDDY (SIDDARTHAREDDY8) wants to merge 1 commit into
Azure:mainfrom
SIDDARTHAREDDY8:oss-bhai-2026-09-14-azure-ai-agents-readme
Open

SIDDARTHA REDDY (SIDDARTHAREDDY8) wants to merge 1 commit into
Azure:mainfrom
SIDDARTHAREDDY8:oss-bhai-2026-09-14-azure-ai-agents-readme

Conversation

@SIDDARTHAREDDY8

Copy link
Copy Markdown

Description

Fixes #48118. Docs-only fix for four small defects in the azure-ai-agents README that cause copy-paste friction:

  • Env var mismatch: the Prerequisites prose said to define PROJECT_ENDPOINT_STRING, but every code snippet and sample reads PROJECT_ENDPOINT (os.environ["PROJECT_ENDPOINT"]), so following the prose leads to a KeyError. Corrected the prose to PROJECT_ENDPOINT.
  • Stale docs link: updated the "create a project" link from the legacy azure/ai-studio/ path to the current azure/ai-foundry/ path.
  • Grammar: "Role assigned can be done" -> "Role assignment can be done"; "Also notices that if you use asynchronous client ... AsyncFunctionTool be discussed in the later sections" -> "Also note that if you use the asynchronous client ... AsyncFunctionTool will be discussed in later sections".

Docs-only; no code or behavior changes.

All SDK Contribution checklist:

  • The pull request does not introduce [breaking changes]
  • CHANGELOG is updated for new features, bug fixes or other significant changes. (docs-only README fix; no changelog entry needed)
  • I have read the contribution guidelines.

General Guidelines and Best Practices

  • Title of the pull request is clear and informative.
  • There are a small number of commits, each of which have an informative message.

Testing Guidelines

  • Pull request includes test coverage for the included changes. (docs-only change; verified the corrected prose now matches every code snippet's os.environ["PROJECT_ENDPOINT"] usage)

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
Successfully started running 1 pipeline(s).
7 pipeline(s) were filtered out due to trigger conditions.
There may be pipelines that require an authorized user to comment /azp run to run.

@github-actions github-actions Bot added AI Agents Community Contribution Community members are working on the issue customer-reported Issues that are reported by GitHub users external to the Azure organization. labels Sep 14, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Thank you for your contribution SIDDARTHA REDDY (@SIDDARTHAREDDY8)! We will review the pull request and get back to you soon.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

The documentation corrections are accurate; only a non-blocking capitalization issue remains.

Pull request overview

Updates the azure-ai-agents README to reduce setup and usage confusion.

Changes:

  • Aligns the endpoint environment variable with samples.
  • Updates the Azure AI Foundry project link.
  • Corrects grammar in role and asynchronous-client guidance.
File summaries
File Description
sdk/ai/azure-ai-agents/README.md Corrects setup documentation, link, and wording.
Review details
  • Files reviewed: 1/1 changed files
  • Comments generated: 1
  • Review effort level: Balanced

💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.

- The project endpoint string. It can be found in your Azure AI Foundry project overview page, under "Project details". Below we will assume the environment variable `PROJECT_ENDPOINT` was defined to hold this value.
- Entra ID is needed to authenticate the client. Your application needs an object that implements the [TokenCredential](https://learn.microsoft.com/python/api/azure-core/azure.core.credentials.tokencredential) interface. Code samples here use [DefaultAzureCredential](https://learn.microsoft.com/python/api/azure-identity/azure.identity.defaultazurecredential). To get that working, you will need:
* An appropriate role assignment. see [Role-based access control in Azure AI Foundry portal](https://learn.microsoft.com/azure/ai-foundry/concepts/rbac-ai-foundry). Role assigned can be done via the "Access Control (IAM)" tab of your Azure AI Project resource in the Azure portal.
* An appropriate role assignment. see [Role-based access control in Azure AI Foundry portal](https://learn.microsoft.com/azure/ai-foundry/concepts/rbac-ai-foundry). Role assignment can be done via the "Access Control (IAM)" tab of your Azure AI Project resource in the Azure portal.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

AI Agents Community Contribution Community members are working on the issue customer-reported Issues that are reported by GitHub users external to the Azure organization.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants