Skip to content

Add 36 AI App Templates missing from awesome-azd gallery#780

Open
haileyvictory wants to merge 5 commits into
Azure:mainfrom
haileyvictory:add-ai-app-templates
Open

Add 36 AI App Templates missing from awesome-azd gallery#780
haileyvictory wants to merge 5 commits into
Azure:mainfrom
haileyvictory:add-ai-app-templates

Conversation

@haileyvictory
Copy link
Copy Markdown
Contributor

@haileyvictory haileyvictory commented Mar 24, 2026

Add 36 AI App Templates to awesome-azd

Summary

Adds 36 templates from ai-app-templates that were missing from awesome-azd.

Changes

  • 36 new template entries appended to \website/static/templates.json\
  • 0 modifications to existing 293 entries (byte-identical)
  • All tags validated against \src/data/tags.tsx\ controlled vocabulary
  • All 36 source repos verified accessible and not archived

Validation

  • CI passing (\ ags_match.test.ts\ + \�uthor_filter.test.ts)
  • All tag values exist in \ ags.tsx\ (azureopenai→openai, golang→go mapped)
  • No duplicate source URLs introduced
  • JSON structure valid, brackets balanced
  • UTF-8 encoding preserved (no corruption)
  • All 36 repos verified accessible via GitHub API

Notes

  • Preview images: 36 entries use \ est.png\ placeholder — maintainers should replace with actual screenshots
  • \ rameworks\ field: omitted (optional, 198/293 existing entries also omit it)
  • Pre-existing issues in original data (not modified): 2 duplicate URLs, 27 missing authorUrl

Adds templates from ai-app-templates gallery that are missing from awesome-azd.
awesome-azd should be the superset of all azd templates.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
haileyvictory and others added 3 commits March 24, 2026 17:49
Rebuild merged JSON to preserve original content byte-identical.
Only appends 37 new entries - zero changes to existing 293 templates.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Remove duplicate entry (azureai-basic-python renamed to get-started-with-ai-chat)
- Update renamed repo URL (document-generation → content-generation)
- Set all preview images to test.png (originals not in repo yet)
- Fill empty IaC field for azure-functions-openai-aisearch-node (bicep)
- Regenerate UUID for renamed source URL

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- azureopenai → openai (29 entries)
- golang → go (1 entry)
- Remove 'featured' tag (1 entry)
- Remove 'azuresignalr' from azureServices (1 entry)
- Trim whitespace from 2 descriptions
- All tags now validated against src/data/tags.tsx
@haileyvictory haileyvictory changed the title Add 37 AI App Templates missing from awesome-azd gallery Add 36 AI App Templates missing from awesome-azd gallery Mar 25, 2026
@haileyvictory haileyvictory marked this pull request as ready for review March 25, 2026 17:11
Copilot AI review requested due to automatic review settings March 25, 2026 17:11
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds 36 missing AI App Templates from ai-app-templates into the awesome-azd gallery index so they show up in the website template gallery.

Changes:

  • Appends 36 new template records to website/static/templates.json
  • Adds metadata for each template (title/description/source/tags/IaC/languages/azureServices)

Comment thread website/static/templates.json Outdated
Comment thread website/static/templates.json
Comment thread website/static/templates.json
Comment on lines +7593 to +7596
"source": "https://github.com/dminkovski/agent-openai-banking-assistant-csharp",
"tags": [
"aicollection"
],
Copy link

Copilot AI Mar 25, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This entry’s source/description indicates it’s an OpenAI/Azure OpenAI template (“agent-openai…”, “generative AI”), but the openai tag is missing (and azureServices also omits openai). If consumers filter templates by openai, this template will be incorrectly excluded. Please align tags/azureServices with the actual dependencies used by the repo (add openai where applicable, or adjust the description if it does not use OpenAI).

Copilot uses AI. Check for mistakes.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@copilot add openai as a tag under azureServices for this template

Comment on lines +7605 to +7611
"azureServices": [
"aca",
"blobstorage",
"azureai",
"managedidentity",
"serviceprincipal"
]
Copy link

Copilot AI Mar 25, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This entry’s source/description indicates it’s an OpenAI/Azure OpenAI template (“agent-openai…”, “generative AI”), but the openai tag is missing (and azureServices also omits openai). If consumers filter templates by openai, this template will be incorrectly excluded. Please align tags/azureServices with the actual dependencies used by the repo (add openai where applicable, or adjust the description if it does not use OpenAI).

Copilot uses AI. Check for mistakes.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@copilot add openai as a tag under azureServices for this template

Comment on lines +7614 to +7615
"title": "Multi Agent Custom Automation Engine Solution Accelerator",
"description": "The Multi-Agent Custom Automation Engine Solution Accelerator is an AI-driven orchestration system that manages a group of AI agents to accomplish tasks based on user input. Powered by AutoGen, Azure OpenAI, Cosmos, and infrastructure services, it provides a ready to go application to use as a reference, allowing you to hit the ground running.",
Copy link

Copilot AI Mar 25, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The description explicitly says “Powered by… Azure OpenAI”, but tags doesn’t include openai and azureServices doesn’t list openai. This creates inconsistent metadata and will likely cause incorrect categorization/filtering. Update tags/azureServices to reflect Azure OpenAI usage (or remove “Azure OpenAI” from the description if not actually used).

Copilot uses AI. Check for mistakes.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@copilot add openai to AzureServices as a tag for this template

Comment on lines +7619 to +7622
"source": "https://github.com/microsoft/Multi-Agent-Custom-Automation-Engine-Solution-Accelerator",
"tags": [
"aicollection"
],
Copy link

Copilot AI Mar 25, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The description explicitly says “Powered by… Azure OpenAI”, but tags doesn’t include openai and azureServices doesn’t list openai. This creates inconsistent metadata and will likely cause incorrect categorization/filtering. Update tags/azureServices to reflect Azure OpenAI usage (or remove “Azure OpenAI” from the description if not actually used).

Copilot uses AI. Check for mistakes.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

PR opened to add openai as tag: #781

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@copilot add openai for this template under azureServices in the highlighted section

Comment on lines +7630 to +7637
"azureServices": [
"appservice",
"keyvault",
"azureai",
"aifoundry",
"serviceprincipal",
"appinsights"
]
Copy link

Copilot AI Mar 25, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The description explicitly says “Powered by… Azure OpenAI”, but tags doesn’t include openai and azureServices doesn’t list openai. This creates inconsistent metadata and will likely cause incorrect categorization/filtering. Update tags/azureServices to reflect Azure OpenAI usage (or remove “Azure OpenAI” from the description if not actually used).

Copilot uses AI. Check for mistakes.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have opened a PR to add the tag, #781 in response

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@copilot update the azureServices for this template to include openai tag, it should be added between lines 7631-7636. make no other updates

resolving duplicate listings of the author url

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@haileyvictory
Copy link
Copy Markdown
Contributor Author

@copilot remove all references to "openai" that are nested under "azureServices". Do not remove any openai mentions from template names or titles. Leave everything else exactly the same, only remove the azureServices openai that we added in our last few comments

Copy link
Copy Markdown
Contributor

@hemarina hemarina left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for doing this! I think we already have openai tag: #781 (comment).

Copy link
Copy Markdown
Collaborator

@kristenwomack kristenwomack left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for adding these!

Copy link
Copy Markdown
Member

@jongio jongio left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few things to fix before merge:

openai in the wrong array (all 36 templates)
All 77 existing templates put openai in azureServices, never in tags. Since openai has azureIcon in tags.tsx, it's an Azure service and doesn't belong in tags.

  • 29 templates already have openai in both tags and azureServices - just remove it from tags
  • 7 templates have it only in tags (e.g., "Build Your Own Copilot", "Multi Agent Custom Automation Engine") - check whether they actually use Azure OpenAI. If yes, move to azureServices. If not, just remove it.

Missing msft tag (32 templates)
32 of 36 templates come from Azure-Samples or microsoft orgs but don't have msft in tags. The 4 community templates (zhenbzha, dminkovski, robertopc1, hengyl) are correct without it.

Missing new tag (all 36)
Newly added templates should include new in tags so they show up as new in the gallery.

Merge conflicts
The PR has merge conflicts with main that need resolving.

Testing
@haileyhuber8 - since 32 of these are Microsoft-authored, can you provide a test pipeline link or proof that these templates deploy successfully?

@v-xuto - please test the 4 community templates:

  • zhenbzha/chainlit-agent
  • dminkovski/agent-openai-banking-assistant-csharp
  • robertopc1/Redis_LLMmemory
  • hengyl/nlweb-agent-demo

@hemarina
Copy link
Copy Markdown
Contributor

hemarina commented Apr 7, 2026

@jongio These templates exist in https://azure.github.io/ai-app-templates/ and they have been verified for success deployment to be added as a part of contribution workflow. cc @v-xuto

Feel free to correct me if I'm wrong @haileyhuber8. During our meeting last Friday, we were talking about adding AI templates to awesome-azd and revisit it in future when we link awesome-azd site with ai-app site (i.e decide if we want to move ai site templates out of awesome-azd or keep it under AI collection).

Copy link
Copy Markdown
Member

@jongio jongio left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Three additional issues beyond the tag placement fixes already requested:

Encoding corruption in descriptions - Four templates have mojibake characters (garbled Unicode) that will render as garbage text in the gallery. Details in inline comments.

Missing languages field - Template "Deploy Your AI Application in Production" has no languages key, so it won't appear in language-based filters.

Multi-URL authorUrl - 22 of 36 templates have comma-separated URLs in authorUrl (e.g., "https://github.com/Azure-Samples, https://github.com/Azure-Samples"). Since this renders as a single link, the URL is broken. Consider using just the first/primary author URL for each.

},
{
"title": "Document Generation and Summarization",
"description": "Generate templates and draft content from your data by identifying relevant documents and summarizing unstructured information​",
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This description contains garbled characters at the end - these are UTF-8 bytes that got double-encoded. Three other templates have the same issue:

  • Line ~7641 (LLM Chat Memory): corrupted em dash should be a hyphen
  • Line ~7665 (Healthcare Agent): corrupted em dash should be a hyphen
  • Line ~7837 (SharePoint knowledge): corrupted curly quote should be a straight apostrophe

The trailing garbage characters here should just be removed.

"IaC": [
"bicep"
],
"id": "ecc1d67a-0bff-5834-888d-642a7a464d23",
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This template is missing the languages field entirely. Based on the repo, it should include "python" and "javascript" so it shows up when filtering by language.

@kristenwomack
Copy link
Copy Markdown
Collaborator

Thanks @haileyvictory — closing the gap between the AI templates collection and awesome-azd is real customer value. A few PRs worth here are also already CHANGES_REQUESTED so this is a partial re-review.

Two PM asks before this can move:

  1. Split the PR. 36 templates in one +982-line diff is hard to review and one issue on a single entry blocks all 36 from landing. Suggest 3–4 smaller batched PRs grouped by scenario, e.g.:

    • Chat / RAG quickstarts
    • Multi-agent / agent framework templates
    • Industry accelerators (banking, conversation mining, content processing, document gen)
    • Language-specific keyless deployments (Python, Go, .NET, Java)

    That lets us merge the clean batches while iterating on the ones with issues.

  2. aicollection tag validation. Per our contributor guide, the aicollection tag is reserved for templates listed at https://azure.github.io/ai-app-templates/. With 36 entries all carrying that tag, we need a per-entry check. Two options:

    • You confirm each is currently on the AI collection site, OR
    • Strip aicollection from entries you can't verify (they can still ship with msft + domain tags)

    Follow-up: this PR also surfaces that we have no automated check for aicollection membership. I'll open a separate issue to add validation to npm test so we don't hit this scale problem again.

Once split, the rebase against main should be much less painful too.

Copy link
Copy Markdown
Contributor

@wbreza wbreza left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Supplemental Review

Adding to the prior feedback from @jongio and the Copilot bot reviewer — these are new findings not yet flagged. Skipping items already covered (openai tag placement, missing msft/new tags, mojibake in descriptions, missing languages on "Deploy Your AI Application in Production", multi-URL authorUrl format, merge conflicts).

🚫 Blocker

Missing community tag on all 4 community templates
The gallery requires every template to carry either msft or community. These four currently have neither:

Template Source
Chainlit Agent zhenbzha/chainlit-agent
Multi Agents Banking Assistant with .NET and SK dminkovski/agent-openai-banking-assistant-csharp
LLM Chat Memory with Azure Managed Redis robertopc1/Redis_LLMmemory
NLWeb Agent Demo hengyl/nlweb-agent-demo

Each has ["aicollection"] or ["aicollection","openai"] but no community. Without it the community/msft filter is broken for these entries.

⚠️ Major

Repeated identical URLs in authorUrl (7 entries)
Distinct from the multi-URL format issue — these list the same org URL 2–4× per co-author, which renders meaningless per-author links. Should be individual GitHub profile URLs (e.g., https://github.com/pamelaFox).

Template Repeated URL Count
OpenAI chat with .NET Aspire (ai-chat-aspire-meai-csharp) https://github.com/Azure-Samples ×2
Entity extraction with Azure OpenAI structured outputs https://github.com/Azure-Samples ×2
Customer Assistant with Java https://github.com/Azure-Samples ×2
Creative Writing Assistant Python (contoso-creative-writer) https://github.com/Azure-Samples ×2
Conversation Knowledge Mining https://github.com/Azure-Samples ×4
Document Generation and Summarization https://github.com/microsoft ×2
Multi Agent Custom Automation Engine https://github.com/microsoft ×2

Repo URLs used as authorUrl (2 entries)
authorUrl should point to a user or org profile, not a repo:

  • Multi-modal Content Processing → https://github.com/microsoft/solution-accelerators (×8)
  • Modernize your code with agents → https://github.com/microsoft/Modernize-your-code-solution-accelerator (×4)

Both should be https://github.com/microsoft.

Verify aicollection on the 4 community templates
Per repo guidelines, aicollection is reserved for templates listed at https://azure.github.io/ai-app-templates/. All 4 community entries above carry this tag — please confirm those community repos actually appear in the AI collection site. If not, aicollection must be removed from those four.

ℹ️ Minor

  • "AI application with SharePoint knowledge and actions" is missing the sharepoint tag (title and description are explicitly about SharePoint; per tags.tsx it has no azureIcon so belongs in the tags array).
  • 5 entries explicitly use named frameworks but omit framework tags:
    • semantickernel — OpenAI + Semantic Kernel chat app quick start, Customer Assistant with Java, Creative Writing Assistant Aspire (aspire-semantic-kernel-creative-writer)
    • chainlit, fastapi — Chainlit Agent (zhenbzha)
    • autogen — Multi Agent Custom Automation Engine ("Powered by AutoGen")
  • Aspire tag question: Several entries are clearly Aspire-based (ai-chat-aspire-meai-csharp, aspire-semantic-kernel-creative-writer) but no aspire tag is applied. aspire is type: "Tools" in tags.tsx — should Tools-type tags appear in tags[] for these? Worth a maintainer call.
  • Possible duplicate concept: "Banking GenAI multi-agent assistant" (agent-openai-java-banking-assistant, Java) and "Home Banking Assistant" (agent-openai-python-banking-assistant, Python) appear to be the same app in two languages by the same author. Are both warranted as separate gallery entries?

Confirmed quantifications

  • 36/36 entries use ./templates/images/test.png placeholder ✅ (already acknowledged in PR description)
  • 36/36 id values are unique valid UUIDs ✅
  • 36/36 source URLs are unique within the diff ✅
  • Mojibake confirmed includes a zero-width space (\u{200b}) in the "Document Generation and Summarization" description

Status note

This PR has unresolved merge conflicts (mergeStateStatus: DIRTY) and the CHANGES_REQUESTED feedback from @jongio (2026-04-07) plus follow-up (2026-04-09) hasn't been addressed in commits on this branch — only the openai tag fix was redirected to #781. The remaining items (new tag, msft tag, mojibake, languages field, authorUrl cleanup, plus the items above) still need resolution here.

Copy link
Copy Markdown
Collaborator

@kristenwomack kristenwomack left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@haileyvictory checking in on this one. The PR has been idle since May 19 and the feedback queue has grown: jongio's openai placement, mojibake, and missing languages, wbreza's blocker on missing community tags for the 4 community entries, the authorUrl cleanup, and my earlier ask to split the batch.

Let's close this PR and we'll take it from here. We'll re-open as 3 or 4 smaller PRs grouped by scenario (Chat/RAG, multi-agent, industry accelerators, language-specific keyless) so the clean batches can land while the messier ones get iterated on.

Thanks for the work that went into this so far. More soon.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants