I am trying to use python and connect my azure ai foundry project using TypeError: AIProjectClient.init() missing 3 required positional arguments: 'subscription_id', 'resource_group_name', and 'project_name'

Question

I am trying to use python and connect my azure ai foundry project using TypeError: AIProjectClient.init() missing 3 required positional arguments: 'subscription_id', 'resource_group_name', and 'project_name'

EV CV 0

   https://microsoft.github.io/build-your-first-agent-with-azure-ai-agent-service-workshop/getting-started/#project-connection-string   I am having issues with connection string

1 answer

Your answer

Answer 1

Ravada Shivaprasad 535 Microsoft External Staff Moderator

Hi EV CV

The error you are encountering occurs because the AIProjectClient.init() method requires three mandatory parameters: subscription_id, resource_group_name, and project_name. To resolve this issue, ensure you provide these parameters when initializing the client in your Python code. First, verify that you are using the correct subscription ID, which can be retrieved using the Azure CLI command az account show --query id --output tsv. Additionally, confirm that your resource group name matches the one used in your Azure AI Foundry deployment by listing available resource groups using az group list --query "[].name" --output tsv. Lastly, make sure that the project name is correctly configured in Azure AI Foundry.

When initializing AIProjectClient, you should provide all necessary parameters along with proper authentication using DefaultAzureCredential. Below is an example of a properly structured initialization:

from azure.ai.foundry import AIProjectClient 
from azure.identity import DefaultAzureCredential 
credential = DefaultAzureCredential()
client = AIProjectClient.init( credential=credential, subscription_id="your-subscription-                  id", resource_group_name="your-resource-group", project_name="your-project-name")

This approach ensures secure authentication and proper connection to your Azure AI Foundry project. For further details on configuring the connection string, you can refer to the official Microsoft documentation: Configure Project Connection. Additionally, if you are facing persistent issues, you may find relevant troubleshooting discussions in the Azure SDK for Python GitHub repository

Thanks

桂學文 Kevin Kuei 125

I've the same issue.

After I providing three 'subscription_id', 'resource_group_name', and 'project_name' , I got diff error messages.

Traceback (most recent call last):
  File "/workspace/Azure_Agent/00.py", line 13, in <module>
    agent = project.agents.get_agent("asst_QGh7Y1f82ZxlmDiqjPC003qi")
  File "/usr/local/lib/python3.10/dist-packages/azure/core/tracing/decorator.py", line 119, in wrapper_use_tracer
    return func(*args, **kwargs)
  File "/usr/local/lib/python3.10/dist-packages/azure/ai/projects/operations/_operations.py", line 1941, in get_agent
    map_error(status_code=response.status_code, response=response, error_map=error_map)
  File "/usr/local/lib/python3.10/dist-packages/azure/core/exceptions.py", line 163, in map_error
    raise error
azure.core.exceptions.ClientAuthenticationError: (None) Unauthorized. Access token is missing, invalid, audience is incorrect (https://ai.azure.com), or have expired.
Code: None
Message: Unauthorized. Access token is missing, invalid, audience is incorrect (https://ai.azure.com), or have expired.

here is the code:

from azure.ai.projects import AIProjectClient
from azure.identity import DefaultAzureCredential
#from azure.ai.agents.models import ListSortOrder
project_client = AIProjectClient(
    credential=DefaultAzureCredential(),
    subscription_id="xxx",
    resource_group_name="yyy",
    project_name="zzz",
    endpoint="aaa"
)
# Create agent with the bing tool and process assistant run
#with project_client:
agent = project_client.agents.create_agent(
    model="gpt-4o",
    name="my-assistant",
    instructions="You are a helpful assistant",
    headers={"x-ms-enable-preview": "true"}
)
print(f"Created agent, ID: {agent.id}")

Ravada Shivaprasad 535 Reputation points Microsoft External Staff Moderator

2025-05-27T23:00:55.1533333+00:00
Hi 桂學文 Kevin Kuei

The error you're encountering—ClientAuthenticationError: Unauthorized. Access token is missing, invalid, audience is incorrect (https://ai.azure.com), or have expired—typically arises when the Azure SDK is unable to obtain a valid access token with the correct audience for Azure AI Foundry. Even though you're using DefaultAzureCredential() for authentication, it doesn't automatically request a token scoped for https://ai.azure.com, which is required by the Azure AI Agent Service.

To resolve this, you need to explicitly request a token with the correct audience. One way to do this is by using a custom token provider that fetches a token for the https://ai.azure.com/.default scope. Here's how you can modify your code:

from azure.identity import DefaultAzureCredential from azure.ai.projects import AIProjectClient credential = DefaultAzureCredential() def get_bearer_token(): token = credential.get_token("https://ai.azure.com/.default") return token.token project_client = AIProjectClient( credential=credential, subscription_id="your-subscription-id", resource_group_name="your-resource-group", project_name="your-project-name", endpoint="your-endpoint" )

Make sure your Azure identity (user or service principal) has the appropriate role assignments, such as Cognitive Services User or AI Foundry Contributor, for the resource you're trying to access. Also, ensure that the token is not expired when making the request.

Reference : official Microsoft documentation on configuring Entra ID for Azure AI Foundry and a related Microsoft Q&A discussion on token audience issues.

Thanks
Ravada Shivaprasad 535 Reputation points Microsoft External Staff Moderator

2025-05-28T20:10:54.3733333+00:00

Hi EV CV

Following up to see if the above answer was helpful. If this answers your query, do click Accept Answer and Yes for was this answer helpful. And, if you have any further query do let us know.

Thanks

Share via

I am trying to use python and connect my azure ai foundry project using TypeError: AIProjectClient.__init__() missing 3 required positional arguments: 'subscription_id', 'resource_group_name', and 'project_name'

1 answer