Adding Container Apps as tool via OpenAPI 3.0 is not registered!

[danielinjesus]

Hello. I want my LangChain app to be registered as agent or tool in AI Foundry Agent Service.
I uploaded the app to Container Apps : https://contapp21--0gkrf2q.thankfulsky-db5b0c67.koreacentral.azurecontainerapps.io/

1. I tried to register it as a tool via OpenAPI 3.0 AI Foundry UI.

I inserted the auto-generated OpenAPI code from FastAPI and hit next button. It buffers some time and there is no job uploaded; it is still 0; why is it?

{"openapi":"3.1.0","info":{"title":"FastAPI","version":"0.1.0"},"paths":{"/":{"get":{"summary":"Hello","operationId":"hello__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/components/{item}":{"get":{"summary":"Get Components","operationId":"get_components_components__item__get","parameters":[{"name":"item","in":"path","required":true,"schema":{"type":"string","title":"Item"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}

2. Foundry SDK : with help of Claude, got this but got the same error. Is this a right approach to register an agent with TripAdvisor into Foundry Portal?

from azure.ai.projects import AIProjectClient
from azure.ai.agents.models import OpenApiTool, OpenApiAnonymousAuthDetails
from azure.identity import DefaultAzureCredential
import requests
import jsonref

# AI Project Connection
client = AIProjectClient(
    endpoint="https://procode-2509-resource.services.ai.azure.com/api/projects/procode-2509",
    credential=DefaultAzureCredential()
)

# Fetch OpenAPI spec
openapi_url = "https://contapp21--0gkrf2q.thankfulsky-db5b0c67.koreacentral.azurecontainerapps.io/openapi.json"
response = requests.get(openapi_url)
openapi_spec = jsonref.loads(response.text)  # jsonref 사용!

print(f"OpenAPI version: {openapi_spec.get('openapi')}")

# OpenAPI tool Generation
auth = OpenApiAnonymousAuthDetails()
openapi_tool = OpenApiTool(
    name="component_analyzer",
    description="Get item components information",
    spec=openapi_spec,
    auth=auth
)

# Agent Generation
agent = client.agents.create_agent(
    model="gpt-5-mini",
    name="Component Assistant",
    instructions="Use component_analyzer to get item components",
    tools=openapi_tool.definitions
)

print(f"Agent created: {agent.id}")

Thank you in advance.

[amynic]

Hi @danielinjesus thanks for sharing the issue your facing - it looks like in the documentation there are a few schema steps that need to be added/edited for Foundry usage - can you confirm you were using these docs to create your schema and add to foundry: https://learn.microsoft.com/en-us/azure/ai-foundry/agents/how-to/tools/openapi-spec

[danielinjesus]

Hello @amynic thanks for your input.

1. I am wondering whether this link explains the case with TripAdvisor since it is separately located at Knowledge section of Foundry Agent and OpenAPI is at Tools section of Foundry Agent.

2. This doc says it should be like this

"securitySchemes": {
     "apiKeyHeader": {
             "type": "apiKey",
             "name": "x-api-key",
             "in": "header"
         }
 }

but TripAdvisor's is a bit different; it has cosoLocationApiLambdaAuthorizer instead of apiKeyHeader; is this okay?

    "securitySchemes": {
      "cosoLocationApiLambdaAuthorizer": {
        "type": "apiKey",
        "name": "key",
        "in": "query"
      }
    }

3. It seems I can't fix the TripAdvisor auto-generated OpenAPI scheme in the Foundry Portal. Is there any way to change it? I don't think any should change though since it is a customized service of AI Foundry for TripAdvisor.

4. The doc you mentioned says "Update your OpenAPI spec to include a security section:"

"security": [
     {  
     "apiKeyHeader": []  
     }  
 ]

The provided OpenAPI has 5 security sections. Where to include the above?

"security": [
          {
            "cosoLocationApiLambdaAuthorizer": []
          }
        ]

Appreciate your answers!