Consider official guidance or sample for wiring up a model to Teams conversational features

[nickwalkmsft]

Would be great to have official guidance or a sample for prompting a model or creating an agent that has awareness that it's running in Teams and can interact with a Teams SDK layer that gives it control over conversational gestures like using responses.

[microsoft-github-policy-service]

Hi @nickwalkmsft! We will investigate and if we require further information we will reach out to you. Please use this link to escalate if you don't get replies in two working days.

Best regards, Teams Platform

[m365-agent-toolkit-assistant]

👋 Hi @nickwalkmsft,

Thank you for reporting this issue! We want to let you know that:

⏱️ Our team will personally review your issue
🎯 You can expect a response within 1 business day

✨ This is an AI-generated initial response
🤖 AI-Generated Preliminary Analysis:

Classification: Feature request — this asks for new official docs/sample coverage, not a broken behavior.

• Learn already documents the need: Teams agents should use Teams SDK to manage context/history, identify conversation location, stream responses, add citations/AI labels, and prompt starters.
• Current docs appear conceptual, not a full end-to-end sample for “model aware it’s running in Teams and controlling conversational gestures.”
• The issue is labeled doc-idea, which matches a documentation gap rather than a product defect.

Existing coverage: Partial coverage exists in Learn, but I didn’t find a separate tracked duplicate/sample issue in the searched repos.

What to do now:

1. Track this as a docs/sample backlog item, not a bug.
2. Ask for a sample covering: Teams context injection, conversation history, streaming, citations, AI label, suggested actions.
3. Point developers meanwhile to Teams SDK/agent UX guidance.

Useful links:

• No similar issues found in the searched repos.
• https://learn.microsoft.com/microsoftteams/platform/bots/how-to/teams-conversational-ai/ai-ux
• https://learn.microsoft.com/microsoftteams/platform/agents-in-teams/overview
• https://learn.microsoft.com/microsoftteams/platform/agents-in-teams/build-first-agent

If helpful, I can draft a proposed doc outline/sample spec for this issue.

---

Note: This is an automated first response generated by AI. A human team member will review your issue and provide a more detailed response soon. We appreciate your patience!