What is needed as a connection ID for using AI Agents with BING GROUNDING?

[Arturo-Quiroga-MSFT]

There is a discrepancy between the MS LEARN DOCS and the samples ion the SDK for AI AGENTS using Bing Grounding:

The MS LEARN DOCS say this:

https://learn.microsoft.com/en-us/azure/ai-services/agents/how-to/tools/bing-code-samples?pivots=python

Your connection ID needs to be in this format:

/subscriptions/<subscription_id>/resourceGroups/<resource_group_name>/providers/Microsoft.CognitiveServices/accounts/<ai_service_name>/projects/<project_name>/connections/<connection_name>

The sample code in the SDK says this:

https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/ai/azure-ai-agents/samples/agents_tools/sample_agents_bing_grounding.py

The ID of the Bing connection, in the format of:

/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.MachineLearningServices/workspaces/{workspace-name}/connections/{connection-name}

Which one is correct?..

Also, can you please provide an example as to how one would go about obtaining the correct connection ID in the format required?

Thank you.

[github-actions]

Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @luigiw @needuv @paulshealy1 @singankit.

[github-actions]

Hi @Arturo-Quiroga-MSFT, I'm an AI Support assistant here to help with your issue. While the Azure SDK team reviews your request, I wanted to provide some possible tips and documentation that might help you in the meantime.

• The connection ID for Bing Grounding is expected in the format using the Microsoft.MachineLearningServices resource, as shown by the SDK sample:

  • Format:
    /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.MachineLearningServices/workspaces/{workspace-name}/connections/{connection-name}

• The MS Learn Docs sample (using CognitiveServices) is not applicable for Bing Grounding.

• To obtain the connection ID, you can retrieve it through the project client’s connections API. For example:

  • Retrieve the connection and use its ID property:

    • Example:

      bing_connection = project_client.connections.get(connection_name=os.environ["BING_CONNECTION_NAME"])
      conn_id = bing_connection.id
      print(conn_id)
      
      # Initialize the Bing Grounding Tool with the connection id
      bing = BingGroundingTool(connection_id=conn_id)

• This approach uses the connection information available in your Azure AI Foundry project.

• References:

  • Sample for Agent with Bing Grounding Tool
  • Azure AI Projects README

The Azure SDK team will respond to your issue shortly. I hope these suggestions are helpful in the meantime. If this comment helped you, please give it a 👍. If the suggestion was not helpful or incorrect, please give it a 👎. Your feedback helps us improve!

[kashifkhan]

Thank you for the feedback @Arturo-Quiroga-MSFT . Ill get this routed over to the right folks who can help you further.

[glharper]

@Arturo-Quiroga-MSFT Thanks for asking about this, we will change the quickstart code in Python to use what was suggested above:

bing_connection = project_client.connections.get(connection_name=os.environ["BING_CONNECTION_NAME"])
conn_id = bing_connection.id
print(conn_id)

As for the actual format of the connection id, both are valid, but the "subscriptions/<subscription_id>/resourceGroups/<resource_group_name>/providers/Microsoft.CognitiveServices/accounts/<ai_service_name>/projects/<project_name>/connections/<connection_name>" template is for Foundry projects, and is recommended for our customers. The other way is a legacy format that may stop working at some point.