Merge branch 'azure-ai-foundry:main' into main

Author: gslnna

samples/agent-catalog/CONTRIBUTING.md

@@ -1,7 +1,10 @@
 # Contributing Agent Code Samples to Foundry Agent Catalog
 Thank you for your interest in contributing Agent Code Samples to the Foundry Agent Catalog repository!
 
-**Please note that the agent code samples in the Foundry Agent Catalog is a curated list. Inclusion of a third-party contributed agent is at the discretion of the Agent Service team that will be reviewing and approving the code sample.**
+> ⚠️ **Important**  
+> When you submit your agent sample(s) to the GitHub "3P-agent-samples” file for availability from the Azure AI Foundry Agent Catalog, you are acknowledging that you are responsible for the submitted content and, as between you and Microsoft, Microsoft is not responsible for any liability that may arise from publication of your agent sample(s) for use by Azure AI Foundry customers.
+
+> The agent code samples in the Foundry Agent Catalog is a curated list. Inclusion of a third-party contributed agent is at the discretion of the Agent Service team that will be reviewing and approving the code sample.
 
 ## 🚀 What to Include
 

samples/microsoft/python/getting-started-agents/3p-tools/InsureMO/README.md

@@ -36,6 +36,7 @@ This project provides sample code and OpenAPI specifications for integrating wit
 - **Travel Insurance Quotation API**: Obtain travel insurance quotes.
 
 All APIs are hosted on Azure Container Apps and require an API key for authentication.
+To obtain API key, please contact [email protected].
 
 ---
 

samples/microsoft/python/getting-started-agents/3p-tools/InsureMO/insureMO_Quotation.py

@@ -127,7 +127,7 @@
     run_steps = project_client.agents.run_steps.list(thread_id=thread.id, run_id=run.id)
 
     # Loop through each step to display information
-    for step in run_steps.data:
+    for step in run_steps:
         print(f"Step {step['id']} status: {step['status']}")
 
         # Check if there are tool calls recorded in the step details

samples/microsoft/python/getting-started-agents/3p-tools/MiHCM/template_newSDK.py

@@ -127,7 +127,7 @@
     run_steps = project_client.agents.run_steps.list(thread_id=thread.id, run_id=run.id)
 
     # Loop through each step to display information
-    for step in run_steps.data:
+    for step in run_steps:
         print(f"Step {step['id']} status: {step['status']}")
 
         # Check if there are tool calls recorded in the step details

samples/microsoft/python/getting-started-agents/3p-tools/PartnerContributingGuide.md

@@ -1,5 +1,8 @@
 # 3p Tool Partner Contributing Guide
 
+> [!IMPORTANT]
+> When you submit your tool code sample(s) to the GitHub "3P-tools" file for availability in Azure AI Foundry, you are acknowledging that you are responsible for the submitted content and, as between you and Microsoft, Microsoft is not responsible for any liability that may arise from availability of your code sample(s) for use by Azure AI Foundry customers.
+
 ## Who should read this?
 This contributing guide is designed for partners who want to bring their APIs as part of the **Azure AI Foundry Agent Service non-Microsoft tools** so that customers can integrate your APIs with Azure AI Foundry Agent service through a tool to retrieve data or integrating with a workflow.
 

samples/microsoft/python/getting-started-agents/3p-tools/Trademo_Global_trade/ReadME.md

@@ -0,0 +1,73 @@
+# Trademo Shipments And Tariff
+
+This Python script demonstrates how to use Azure AI to create an agent that queries global trade duties using an OpenAPI specification.
+
+## About Tool:
+- Name: Trademo Shipments And Tariff
+- Description: Provides latest duties and past shipment data for trade between multiple countries
+
+
+## Features
+- Creates an Azure AI Project client
+- Sets up OpenAPI connection for global trade data
+- Processes trade duty queries
+- Handles thread/message management
+
+## Prerequisites
+- Azure subscription
+- Azure AI Projects resource
+- Python 3.8+
+- Azure CLI installed and logged in
+- Required Python packages:
+  - azure-ai-projects
+  - azure-identity
+  - jsonref
+  - azure-ai-agents
+
+## Installation
+Install dependencies:
+```bash
+pip install azure-ai-projects azure-identity azure-ai-agents jsonref
+```
+
+
+## Usage
+Run the script:
+```bash
+python trademo_and_tariff.py
+```
+
+Before running the sample:
+
+Obtain the sessionid from trademo which serves as the API_KEY.
+
+Set up a custom key connection, name the key as 'sessionid' and save the connection name.
+
+Save that connection name as the PROJECT_OPENAPI_CONNECTION_NAME environment variable
+
+
+Set this environment variables with your own values:
+PROJECT_ENDPOINT - the Azure AI Project endpoint, as found in your Foundry Project.
+MODEL - name of the model deployment in the project to use Agents against
+CONNECTION_ID - The ID of connection(connection id should be in the format "/subscriptions/<sub-id>/resourceGroups/<your-rg-name>/providers/Microsoft.CognitiveServices/accounts/<your-ai-services-name>/projects/<your-project-name>/connections/<your-connection-name>")
+
+
+## Example queries processed by the tool:
+- "How many GPUs(HS code 847330) were imported to United States from China in February 2025?"
+- "which were the top countries based on shipment value that exported jewellery(HS code 711319) to usa in 2024?"
+- "Which countries are the biggest exporter of lithium ion battery(HS code 850760) to the US in 2024?"
+- "what is the duty of import for jewllery(HS code =  711319) from India to US?"
+- "Compare current duties on lithium ion batteries(HS code 850760) imported to US"
+
+## Notes
+- The script creates and deletes the agent during execution
+- OpenAPI connection requires additional setup in Azure
+- The agent assumes HS 6-digit codes for products automatically
+- Error handling is included for failed runs
+
+
+## Contact
+For any queries, please follow the below escalation matrix:
+- [[email protected]](mailto:[email protected])
+- [[email protected]](mailto:[email protected])
+- [[email protected]](mailto:[email protected])