Skip to content

Commit b14d812

Browse files
authored
Add AI tools one-pager for Azure SDK for Python (#46291)
* Add AI tools one-pager for Azure SDK for Python * Add VS Code to AI tools list * Add aka.ms short link reference * Rephrase intro sentence for clarity * Add update instructions, azure-skills link, remove en-us from URLs * Add feedback section, fix further reading links
1 parent 1da24cc commit b14d812

1 file changed

Lines changed: 70 additions & 0 deletions

File tree

doc/sdk_and_ai.md

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
# Using the Azure SDK for Python with AI tools
2+
3+
AI-powered coding tools can help you write, understand, and debug applications that use the Azure SDK.
4+
This page lists common options and integrations available today.
5+
6+
This page can be linked by [aka.ms/azsdk/python/ai](https://aka.ms/azsdk/python/ai)
7+
8+
## AI coding tools
9+
10+
Several tools support AI-assisted development with the Azure SDK:
11+
12+
| Tool | Description |
13+
|---|---|
14+
| [VS Code](https://code.visualstudio.com/) | Code editor with built-in AI features and Copilot integration |
15+
| [GitHub Copilot](https://github.com/features/copilot) | AI code completion and chat inside VS Code, Visual Studio, JetBrains IDEs, and GitHub.com |
16+
| [Copilot CLI](https://docs.github.com/en/copilot/github-copilot-in-the-cli/about-github-copilot-in-the-cli) | AI assistance for shell commands and Azure CLI usage |
17+
| [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | Terminal-based AI coding agent from Anthropic |
18+
| [Cursor](https://www.cursor.com/) | AI-first code editor with chat and inline editing |
19+
| [Aider](https://aider.chat/) | Terminal-based AI pair programming tool |
20+
21+
This is not an exhaustive list — most AI coding tools that support chat or code generation can work with the Azure SDK.
22+
23+
## Azure MCP Server
24+
25+
The [Azure MCP Server](https://learn.microsoft.com/azure/developer/azure-mcp-server/get-started) exposes Azure resource operations to AI tools through the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/).
26+
This lets an AI coding agent query, create, and manage Azure resources directly during a conversation.
27+
28+
See the [getting started guide](https://learn.microsoft.com/azure/developer/azure-mcp-server/get-started) for setup instructions.
29+
30+
## Azure SDK skills
31+
32+
The Microsoft skills marketplace provides Azure SDK skills that give AI agents context about Azure SDK conventions, code generation, and package management. These skills work with CLI-based AI tools that support plugins, such as Claude Code and Copilot CLI.
33+
34+
Install the Microsoft skills marketplace:
35+
36+
```
37+
/plugin marketplace add Microsoft/skills
38+
```
39+
40+
Install the Azure SDK skills plugin:
41+
42+
```
43+
/plugin install azure-sdk-python@skills
44+
```
45+
46+
Verify installation:
47+
48+
```
49+
/plugin list
50+
```
51+
52+
Update the plugin:
53+
54+
```
55+
/plugin update azure-sdk-python@skills
56+
```
57+
58+
Skills provide domain-specific context that helps AI tools generate more accurate SDK code.
59+
60+
For operational Azure tasks (managing resources, querying services), see the [Azure skills](https://github.com/microsoft/azure-skills) repository.
61+
62+
## Further reading
63+
64+
- [Azure SDK for Python documentation](https://learn.microsoft.com/azure/developer/python/sdk/azure-sdk-overview)
65+
- [Azure SDK design guidelines](https://azure.github.io/azure-sdk/python_design.html)
66+
- [Azure MCP Server](https://learn.microsoft.com/azure/developer/azure-mcp-server/get-started)
67+
68+
## Feedback
69+
70+
If you have feedback on your AI experience with the Azure SDK for Python, [open an issue](https://github.com/Azure/azure-sdk-for-python/issues/new/choose) on the repository.

0 commit comments

Comments
 (0)