.Net: Python: Bug: OpenAPI plugin sends array and boolean query parameters as Python repr (tags=['a', 'b'], active=True)

Aperta
#14,788 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 3 giorni

@jeevan1098 ci sta già lavorando.

Dal 12/11/2026.

  • #14789 di @jeevan1098 — aperta
  • #14800 di @DYNOSuprovo — aperta

Valutazione

Difficoltà
3/5
Tempo stimato
1-2 giorni
Idoneità per principianti
35/100
Tipo di issue
Bug
Chiarezza
Specificata chiaramente
Stato di attività
Ferma
Stack tecnologico
openapi, python
Ambito
api

Direzione di ricerca

Start with python/semantic_kernel/connectors/openapi_plugin/models/rest_api_operation.py, especially the query, header, and path parameter handling cited in the issue, and check how the .NET OpenAPI plugin serializes arrays. Use the offline httpx.MockTransport reproduction to inspect the captured URL. Done means array query values use repeated keys and booleans are lowercase; account for the linked open pull request before starting.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

.NET python triage

Describe the bug

The OpenAPI plugin builds the query string with urlencode(segments) and passes argument values through unchanged:

https://github.com/microsoft/semantic-kernel/blob/25bd1bb67c38976bb13958783572efa57d3445d4/python/semantic_kernel/connectors/openapi_plugin/models/rest_api_operation.py#L386-L400

Without doseq=True, urlencode calls str() on each value. So an array query parameter is sent as Python's list repr (['red', 'blue']), and a boolean is sent as True/False. APIs can't parse either. OpenAPI's default for query parameters is style: form, explode: true, which means tags=red&tags=blue and active=true. The .NET OpenAPI plugin already serializes arrays this way.

The schema advertised to the model says {"type": "array", "items": {"type": "string"}}, so a tool call from the model hits this.

Header and path parameters have the same problem, since they use str(argument) (L218, L331).

To Reproduce

semantic-kernel 1.47.0. rest_api_operation.py is the same on main (25bd1bb6). This runs offline: httpx.MockTransport captures the request, and the server is an IP literal so the URL validator doesn't need DNS.

import asyncio, httpx
from semantic_kernel import Kernel
from semantic_kernel.connectors.openapi_plugin import OpenAPIFunctionExecutionParameters

spec = {
    "openapi": "3.0.1", "info": {"title": "t", "version": "1"},
    "servers": [{"url": "https://93.184.216.34"}],
    "paths": {"/items": {"get": {
        "operationId": "listItems",
        "parameters": [
            {"name": "tags", "in": "query", "schema": {"type": "array", "items": {"type": "string"}}},
            {"name": "active", "in": "query", "schema": {"type": "boolean"}},
        ],
        "responses": {"200": {"description": "ok"}},
    }}},
}

seen = []
def handler(request):
    seen.append(str(request.url))
    return httpx.Response(200, json={})

async def main():
    client = httpx.AsyncClient(transport=httpx.MockTransport(handler))
    kernel = Kernel()
    plugin = kernel.add_plugin_from_openapi(
        "api", openapi_parsed_spec=spec,
        execution_settings=OpenAPIFunctionExecutionParameters(http_client=client),
    )
    await kernel.invoke(plugin["listItems"], tags=["red", "blue"], active=True)
    print(seen[0])

asyncio.run(main())

Output:

https://93.184.216.34/items?tags=%5B%27red%27%2C+%27blue%27%5D&active=True

Expected behavior

https://93.184.216.34/items?tags=red&tags=blue&active=true

(form/explode, the OpenAPI default for query parameters), with booleans written as JSON true/false.

Platform

  • Language: Python
  • Source: semantic-kernel 1.47.0 (pip) / main at 25bd1bb6
  • AI model: n/a (no model call needed)
  • IDE: n/a
  • OS: Windows 11, Python 3.12

Additional context

The parser doesn't read style/explode from the spec yet (RestApiParameter is always built without them), so the smallest fix is to serialize lists as repeated keys (doseq=True) and booleans as lowercase. Happy to send a fix if that helps.

Lingua principale
C#
Stelle
28.8k
Fork
4.9k
Merge medio
2g 17h
PR unite (30g)
48

Preparare l'ambiente

Apri in Codespaces

Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di microsoft/semantic-kernel

Tutte le issue di microsoft/semantic-kernel

Issue simili

Altre issue su C#

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.