Loading source
Pulling the file list, source metadata, and syntax-aware rendering for this listing.
Source from repo
Build and deploy AI applications on Azure AI Foundry using Microsoft's model catalog and AI services
Files
Skill
Size
Entrypoint
Format
Open file
Syntax-highlighted preview of this file as included in the skill package.
foundry-agent/create/references/agent-tools.md
1# Agent Tools — Simple Tools23Add tools to agents to extend capabilities. This file covers tools that work without external connections. For tools requiring connections/RBAC setup, see:4- [Web Search tool](tool-web-search.md) — real-time public web search with citations (default for web search)5- [Bing Grounding tool](tool-bing-grounding.md) — web search via dedicated Bing resource (only when explicitly requested)6- [Azure AI Search tool](tool-azure-ai-search.md) — private data grounding with vector search7- [MCP tool](tool-mcp.md) — remote Model Context Protocol servers89## Code Interpreter1011Enables agents to write and run Python in a sandboxed environment. Supports data analysis, chart generation, and file processing. Has [additional charges](https://azure.microsoft.com/pricing/details/cognitive-services/openai-service/) beyond token-based fees.1213> Sessions: 1-hour active / 30-min idle timeout. Each conversation = separate billable session.1415For code samples, see: [Code Interpreter tool documentation](https://learn.microsoft.com/azure/ai-foundry/agents/how-to/tools/code-interpreter?view=foundry)1617## Function Calling1819Define custom functions the agent can invoke. Your app executes the function and returns results. Runs expire 10 minutes after creation — return tool outputs promptly.2021> **Security:** Treat tool arguments as untrusted input. Don't pass secrets in tool output. Use `strict=True` for schema validation.2223For code samples, see: [Function Calling tool documentation](https://learn.microsoft.com/azure/ai-foundry/agents/how-to/tools/function-calling?view=foundry)2425## Tool Summary2627| Tool | Connection? | Reference |28|------|-------------|-----------|29| `CodeInterpreterTool` | No | This file |30| `FileSearchTool` | No (vector store required) | [tool-file-search.md](tool-file-search.md) |31| `FunctionTool` | No | This file |32| `WebSearchPreviewTool` | No | [tool-web-search.md](tool-web-search.md) |33| `BingGroundingAgentTool` | Yes (Bing) | [tool-bing-grounding.md](tool-bing-grounding.md) |34| `AzureAISearchAgentTool` | Yes (Search) | [tool-azure-ai-search.md](tool-azure-ai-search.md) |35| `MCPTool` | Optional | [tool-mcp.md](tool-mcp.md) |3637> ⚠️ **Default for web search:** Use `WebSearchPreviewTool` unless the user explicitly requests Bing Grounding or Bing Custom Search.3839> Combine multiple tools on one agent. The model decides which to invoke.4041## References4243- [Tool Catalog](https://learn.microsoft.com/azure/ai-foundry/agents/concepts/tool-catalog?view=foundry)44- [Code Interpreter](https://learn.microsoft.com/azure/ai-foundry/agents/how-to/tools/code-interpreter?view=foundry)45- [Function Calling](https://learn.microsoft.com/azure/ai-foundry/agents/how-to/tools/function-calling?view=foundry)46