Skip to main content
Microsoft Foundry gives you several ways to build, from a single model call to a fully containerized agent. This article helps you decide how to build your agent and which developer surface to use. Each section links to the canonical quickstart or overview so you can go deeper. If you’re brand new, start with the recommended path for new developers.

​
Start by building an agent

Most projects on Foundry center on an agent: a model paired with instructions and tools that can reason over a request and take action. The main decision is how much you want to customize and control how that agent runs. Think of it as a spectrum from declarative to full code.
  • Declarative, with the least to manage. Specify instructions, choose a model, and attach tools in the Foundry portal or with the SDK. Foundry hosts and runs the agent for you, with no application code or containers to maintain. In Foundry, this is a prompt agent. Create a prompt agent.
  • Full code, with the most control. Bring your own code or framework (for example, Microsoft Agent Framework, LangGraph, or Semantic Kernel), package it as a container, and Foundry runs it with a managed endpoint, scaling, identity, and observability. In Foundry, this is a hosted agent. Deploy a hosted agent.
You can start declarative and move to code as your needs grow. For a detailed comparison, see What are hosted agents?. For the end-to-end build, test, and ship cycle, see the agent development lifecycle. Not building an agent yet? If you only need to send prompts to a model with no tools or orchestration, start with a single model call.

​
Choose your developer surface

Foundry supports several surfaces. Many developers combine them, for example, prototyping in the portal and then moving to code. Follow these steps to go from zero to a working integration:
  1. Make your first model call. Set up your environment and send a prompt with the build with models and agents quickstart.
  2. Set up your developer environment. Install the CLI and SDK so you can build in code. See Set up your developer environment.
  3. Choose a model. Browse the catalog and compare options in the Foundry Models overview.
  4. Build your first agent. Start with a prompt agent, or go straight to a Hosted agent if you want to bring your own code.
  5. Add tools and knowledge. Extend your agent with tools, retrieval, and memory from the tools overview.

​
Related content