[Dev support]: [Teams AI SDK - Python] Task Module invocation fails with error: "<BotError> Agent returned unsuccessful status code: InternalServerError"

[PjPraveenkumar]

Please be sure to check the Discussions Q&A section before filing a new question.

Question

The partner was attempting to invoke an Adaptive Card-based Task Module using the Teams AI SDK for Python but encountered the following error. I have shared the exact task_module_fetch method implementation we used for reference.

Traceback (most recent call last):
File "/Users/sgolebiewski/workspace/ca-ms-teams-integration/wip/SNOW-2144466-ac-payload/.venv/lib/python3.12/site-packages/msrest/serialization.py", line 494, in _serialize
is_xml_model_serialization = kwargs["is_xml"]
~~~~~~^^^^^^^^^^
KeyError: 'is_xml'

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
File "/Users/sgolebiewski/workspace/ca-ms-teams-integration/wip/SNOW-2144466-ac-payload/.venv/lib/python3.12/site-packages/botbuilder/core/integration/aiohttp_channel_service_exception_middleware.py", line 21, in aiohttp_error_middleware
response = await handler(request)
^^^^^^^^^^^^^^^^^^^^^^
File "/Users/sgolebiewski/workspace/ca-ms-teams-integration/ca-multi-channel-integrations-code-samples/teams-ai/04-task-modules/src/api.py", line 21, in on_messages
res = await app.process(req)
^^^^^^^^^^^^^^^^^^^^^^
File "/Users/sgolebiewski/workspace/ca-ms-teams-integration/wip/SNOW-2144466-ac-payload/.venv/lib/python3.12/site-packages/teams/app.py", line 742, in process
return await self._adapter.process(request, self)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/Users/sgolebiewski/workspace/ca-ms-teams-integration/wip/SNOW-2144466-ac-payload/.venv/lib/python3.12/site-packages/teams/teams_adapter.py", line 101, in process
res = await super().process(
^^^^^^^^^^^^^^^^^^^^^^
File "/Users/sgolebiewski/workspace/ca-ms-teams-integration/wip/SNOW-2144466-ac-payload/.venv/lib/python3.12/site-packages/botbuilder/integration/aiohttp/cloud_adapter.py", line 108, in process
data=serializer_helper(invoke_response.body),
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/Users/sgolebiewski/workspace/ca-ms-teams-integration/wip/SNOW-2144466-ac-payload/.venv/lib/python3.12/site-packages/botbuilder/core/serializer_helper.py", line 40, in serializer_helper
return serializer._serialize(object_to_serialize)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/Users/sgolebiewski/workspace/ca-ms-teams-integration/wip/SNOW-2144466-ac-payload/.venv/lib/python3.12/site-packages/msrest/serialization.py", line 496, in _serialize
is_xml_model_serialization = kwargs.setdefault("is_xml", target_obj.is_xml_model())
^^^^^^^^^^^^^^^^^^^^^^^
AttributeError: 'dict' object has no attribute 'is_xml_model

Code snippets

def build_simple_text_ac(text: str) -> dict:
    return {
        "type": "AdaptiveCard",
        "$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
        "version": "1.5",
        "body": [
            {
                "type": "TextBlock",
                "text": text,
                "wrap": True
            }
        ]
    }

@app.task_modules.fetch("action_submit_task_module")
async def on_action_submit_task_module(context: TurnContext, _state: TurnState, data: dict) -> TaskModuleTaskInfo:
    print(f"[on_action_submit_task_module] handler triggered: {data}")

    # Respond with a task module response
    return TaskModuleTaskInfo(
        title="Action Submit Task Module",
        height="medium",
        width="medium",
        card=CardFactory.adaptive_card(build_simple_text_ac("Task Module triggered by Action.Submit"))
    )

here is AC example from my sample code: 
{
  "type": "AdaptiveCard",
  "$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
  "version": "1.5",
  "msteams": {
    "width": "Full"
  },
  "body": [
    {
      "type": "ActionSet",
      "actions": [
        {
          "type": "Action.Submit",
          "title": "Action.Submit",
          "verb": "action_submit_task_module",
          "data": {
            "msteams": {
              "type": "task/fetch",
              "verb": "action_submit_task_module"
            },
            "verb": "action_submit_task_module",
            "data_1": 123,
            "data_2": "abc"
          }
        }
      ]
    }
  ]
}

Note: please use this template to file your questions regarding implementation. Once your question is answered, our team will move this question to Q&A in Discussions for findability.

[lilyydu]

Hey @PjPraveenkumar, you mentioned in the Teams channel post that this setup was working correctly 2 weeks ago?

[sayali-MSFT]

Hello @PjPraveenkumar ,Could you please confirm what lilyydu asked?

[PjPraveenkumar]

Hi @lilyydu yes it was working fine like three weeks ago.

[motamed]

Hello,
I have the same issue when enabling the feedback button function
it was working fine couple weeks ago

and here is the error i get :

2025-06-30T05:18:50.3183488Z KeyError: 'is_xml'
2025-06-30T05:18:50.3183552Z
2025-06-30T05:18:50.3183610Z During handling of the above exception, another exception occurred:
2025-06-30T05:18:50.3183680Z
2025-06-30T05:18:50.3183911Z Traceback (most recent call last):
2025-06-30T05:18:50.3188343Z   File "/tmp/8ddaee022defc8c/antenv/lib/python3.11/site-packages/botbuilder/core/integration/aiohttp_channel_service_exception_middleware.py", line 21, in aiohttp_error_middleware
2025-06-30T05:18:50.3188645Z     response = await handler(request)
2025-06-30T05:18:50.3188738Z                ^^^^^^^^^^^^^^^^^^^^^^
2025-06-30T05:18:50.3188784Z   File "/tmp/8ddaee022defc8c/api.py", line 23, in on_messages
2025-06-30T05:18:50.3188837Z     res = await app.process(req)
2025-06-30T05:18:50.3188882Z           ^^^^^^^^^^^^^^^^^^^^^^
2025-06-30T05:18:50.3188950Z   File "/tmp/8ddaee022defc8c/antenv/lib/python3.11/site-packages/teams/app.py", line 742, in process
2025-06-30T05:18:50.3189009Z     return await self._adapter.process(request, self)
2025-06-30T05:18:50.3189058Z            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2025-06-30T05:18:50.3189109Z   File "/tmp/8ddaee022defc8c/antenv/lib/python3.11/site-packages/teams/teams_adapter.py", line 101, in process
2025-06-30T05:18:50.3189181Z     res = await super().process(
2025-06-30T05:18:50.3189231Z           ^^^^^^^^^^^^^^^^^^^^^^
2025-06-30T05:18:50.3189287Z   File "/tmp/8ddaee022defc8c/antenv/lib/python3.11/site-packages/botbuilder/integration/aiohttp/cloud_adapter.py", line 108, in process
2025-06-30T05:18:50.3189344Z     data=serializer_helper(invoke_response.body),
2025-06-30T05:18:50.3189421Z          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2025-06-30T05:18:50.3189479Z   File "/tmp/8ddaee022defc8c/antenv/lib/python3.11/site-packages/botbuilder/core/serializer_helper.py", line 40, in serializer_helper
2025-06-30T05:18:50.3189536Z     return serializer._serialize(object_to_serialize)
2025-06-30T05:18:50.3189605Z            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2025-06-30T05:18:50.3189663Z   File "/tmp/8ddaee022defc8c/antenv/lib/python3.11/site-packages/msrest/serialization.py", line 496, in _serialize
2025-06-30T05:18:50.3189722Z     is_xml_model_serialization = kwargs.setdefault("is_xml", target_obj.is_xml_model())
2025-06-30T05:18:50.3189782Z                 

[PjPraveenkumar]

hello @lilyydu @sayali-MSFT Could you please advice ?

[sayali-MSFT]

@lilyydu ,Could you please help on the above query?

[lilyydu]

Hi @lilyydu yes it was working fine like three weeks ago.

Hi, no changes were made - it just stopped working 3 weeks later?

[kaushikt]

Hello,

I have the same issue on the Teams feedback. Did anyone face it?

{
"errorCode": 1008,
"message": "Agent returned unsuccessful status code InternalServerError",
"standardizedError": {
"errorCode": 1008,
"errorSubCode": 1,
"errorDescription": "Agent returned unsuccessful status code InternalServerError"
}
}

Using the below Python snippet.

class FeedbackLoopData(BaseModel):
action_name: str
reply_to_id: str
action_value: str = ""

@app.feedback_loop()
async def feedback_loop(
context: TurnContext,
state: AppTurnState,
feedback_data: FeedbackLoopData,
):
# 1) Skip the Teams “health check” invoke (no payload)
if not feedback_data.action_value:
return

# 2) Skip any duplicate invoke (fires twice per click)
last = getattr(state, "last_feedback_id", None)
if feedback_data.reply_to_id == last:
    return
state.last_feedback_id = feedback_data.reply_to_id
await state.save(context)

# 3) Send your message _and_ immediately follow it with an invoke_response
#    so Teams sees the proper HTTP 200 right away.
await context.send_activity(
    Activity(
        type=ActivityTypes.message,
        text="✅ Feedback received! Thank you."
    )
)
# 4) Now send the invokeResponse activity to close the loop:
await context.send_activity(
    Activity(
        type=ActivityTypes.invoke_response,
        value=None
    )
)

[PjPraveenkumar]

Hi @lilyydu could you please help with the above issue ?

[lilyydu]

Hi @PjPraveenkumar, my colleague @aacebo is looking into this issue - we will follow once investigation is complete

[aacebo]

@PjPraveenkumar looks like you are using the wrong decorator, the task_modules.fetch() decorator is used to create a fetch route while the task_modules.submit() decorator is used to handle submissions.

[aacebo]

@kaushikt remove the last line where you send an invoke response, you do not need to do that the SDK does so for you, attempting to send None or two invoke responses (since the SDK is already sending one for you) will result in errors most likely. https://github.com/microsoft/teams-ai/blob/main/python/packages/ai/teams/app.py#L644

[PjPraveenkumar]

Hi @aacebo with the correct decorator also I'm facing the same issue as partner, could you please advise ?

`@app.task_modules.fetch("action_submit_task_module")
async def on_teams_task_module_fetch(
context: TurnContext,
state: TurnState[ConversationState, UserState, TempState],
data: dict
):
"""
Called when the user selects an option from the displayed HeroCard or AdaptiveCard.

:param context: The context object for the turn.
:param state: The turn state object.
:param data: The data from the task module request.
:return: A TaskModuleTaskInfo or str.
"""
# You can access submitted data via the 'data' parameter
card_task_fetch_value = data.get("data")

task_info = TaskModuleTaskInfo(
    title="Adaptive Card Task Module",
    height=400,
    width=500,
    card=__create_adaptive_card_attachment()
)

return task_info

def __create_adaptive_card_attachment() -> Attachment:
"""
Creates an AdaptiveCard attachment from a JSON file..

    :return: An Attachment object containing the AdaptiveCard.
    """
    card_path = os.path.join(os.getcwd(), "resources/adaptiveCard.json")
    with open(card_path, "rb") as in_file:
        card_data = json.load(in_file)

    return CardFactory.adaptive_card(card_data)`

[PjPraveenkumar]

hello @aacebo @lilyydu Any suggestions for above one ?