foundry-prompt-agents

Create and manage Microsoft Foundry prompt agents with model instructions and tool wiring.

5|2|Updated Apr 28, 2026
One-click install
npx skills add https://github.com/aiappsgbb/awesome-gbb --skill foundry-prompt-agents
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: foundry-prompt-agents
Source: https://github.com/aiappsgbb/awesome-gbb/tree/main/skills/foundry-prompt-agents
Command: npx skills add https://github.com/aiappsgbb/awesome-gbb --skill foundry-prompt-agents

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you create and operate Microsoft Foundry prompt agents without writing containerized code, so you can go from idea to a working tool-using agent faster.

Core Features & Use Cases

  • Create prompt agents declaratively using the azure-ai-projects PromptAgentDefinition with only a model and instructions (no Docker, no custom build step).
  • Wire in built-in and remote tools including web search, code interpreter, file search, MCP, and OpenAPI-based function tooling.
  • Chat, version, and publish via the Conversations API, immutable create_version flows, and stable published agent application endpoints.

Use case: You need a support research assistant that can ground answers with web citations and query a customer document index, while keeping changes safe through versioning and publishing.

Quick Start

Create a Foundry prompt agent version named hello that uses gpt-5-mini with instructions to answer user questions, then chat with it using the Conversations API.

Frequently Asked Questions about foundry-prompt-agents

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Microsoft Foundry prompt agent without writing containerized code?

You can create a Foundry prompt agent declaratively using the azure-ai-projects PromptAgentDefinition by specifying a model and instructions, eliminating the need for Docker or custom build steps.

What tools can I wire into a Foundry declarative prompt agent?

Foundry prompt agents support wiring built-in tools like web search, code interpreter, and file search, alongside remote MCP tools and OpenAPI-based function tooling for extended capabilities.

Does Foundry prompt agent versioning support immutable changes?

Yes, Foundry prompt agent versioning uses an immutable create_version flow, ensuring changes to model instructions and tool wiring are tracked safely through stable published agent application endpoints.

Can I pass runtime configuration to a Foundry prompt agent?

Yes, you can use optional structured_inputs when invoking the Conversations API to provide runtime tool configuration and dynamic parameters to the Foundry prompt agent.

How does the Conversations API target a specific agent in Foundry?

The Conversations API targets a specific Foundry prompt agent using agent_reference targeting, routing the chat invocation to the correct published agent application endpoint.