MR
Mayur Rathi
@mayurrathi
⭐ 40.7k GitHub stars

Azure Ai Projects Py

Azure Ai Projects Py is an code AI skill with a core value of Build AI applications using the Azure AI Projects Python SDK (azure-ai-projects). It helps developers solve real-world problems in the code domain, boosting efficiency, automating repetitive tasks, and optimizing workflows.

Build AI applications using the Azure AI Projects Python SDK (azure-ai-projects). Use when working with Foundry project clients, creating versioned agents with PromptAgentDefinition, running evalua...

Last verified on: 2026-07-08

Quick Facts

Category code
Works With Claude
Source sickn33/antigravity-awesome-skills
Stars ⭐ 40.7k
Last Verified 2026-07-08
Risk Level Low
mkdir -p ./skills/azure-ai-projects-py && curl -sfL https://raw.githubusercontent.com/sickn33/antigravity-awesome-skills/main/skills/azure-ai-projects-py/SKILL.md -o ./skills/azure-ai-projects-py/SKILL.md

Run in terminal / PowerShell. Requires curl (Unix) or PowerShell 5+ (Windows).

Skill Content

# Azure AI Projects Python SDK (Foundry SDK)


Build AI applications on Microsoft Foundry using the `azure-ai-projects` SDK.


Installation


bash 
pip install azure-ai-projects azure-identity

Environment Variables


bash 
AZURE_AI_PROJECT_ENDPOINT="https://<resource>.services.ai.azure.com/api/projects/<project>"
AZURE_AI_MODEL_DEPLOYMENT_NAME="gpt-4o-mini"

Authentication


python 
import os
from azure.identity import DefaultAzureCredential
from azure.ai.projects import AIProjectClient

credential = DefaultAzureCredential()
client = AIProjectClient(
    endpoint=os.environ["AZURE_AI_PROJECT_ENDPOINT"],
    credential=credential,
)

Client Operations Overview


| Operation | Access | Purpose |

|-----------|--------|---------|

| `client.agents` | `.agents.*` | Agent CRUD, versions, threads, runs |

| `client.connections` | `.connections.*` | List/get project connections |

| `client.deployments` | `.deployments.*` | List model deployments |

| `client.datasets` | `.datasets.*` | Dataset management |

| `client.indexes` | `.indexes.*` | Index management |

| `client.evaluations` | `.evaluations.*` | Run evaluations |

| `client.red_teams` | `.red_teams.*` | Red team operations |


Two Client Approaches


1. AIProjectClient (Native Foundry)


python 
from azure.ai.projects import AIProjectClient

client = AIProjectClient(
    endpoint=os.environ["AZURE_AI_PROJECT_ENDPOINT"],
    credential=DefaultAzureCredential(),
)

# Use Foundry-native operations
agent = client.agents.create_agent(
    model=os.environ["AZURE_AI_MODEL_DEPLOYMENT_NAME"],
    name="my-agent",
    instructions="You are helpful.",
)

2. OpenAI-Compatible Client


python 
# Get OpenAI-compatible client from project
openai_client = client.get_openai_client()

# Use standard OpenAI API
response = openai_client.chat.completions.create(
    model=os.environ["AZURE_AI_MODEL_DEPLOYMENT_NAME"],
    messages=[{"role": "user", "content": "Hello!"}],
)

Agent Operations


Create Agent (Basic)


python 
agent = client.agents.create_agent(
    model=os.environ["AZURE_AI_MODEL_DEPLOYMENT_NAME"],
    name="my-agent",
    instructions="You are a helpful assistant.",
)

Create Agent with Tools


python 
from azure.ai.agents import CodeInterpreterTool, FileSearchTool

agent = client.agents.create_agent(
    model=os.environ["AZURE_AI_MODEL_DEPLOYMENT_NAME"],
    name="tool-agent",
    instructions="You can execute code and search files.",
    tools=[CodeInterpreterTool(), FileSearchTool()],
)

Versioned Agents with PromptAgentDefinition


python 
from azure.ai.projects.models import PromptAgentDefinition

# Create a versioned agent
agent_version = client.agents.create_version(
    agent_name="customer-support-agent",
    definition=PromptAgentDefinition(
        model=os.environ["AZURE_AI_MODEL_DEPLOYMENT_NAME"],
        instructions="You are a customer support specialist.",
        tools=[],  # Add tools as needed
    ),
    version_label="v1.0",
)

See references/agents.md for detailed agent patterns.


Tools Overview


| Tool | Class | Use Case |

|------|-------|----------|

| Code Interpreter | `CodeInterpreterTool` | Execute Python, generate files |

| File Search | `FileSearchTool` | RAG over uploaded documents |

| Bing Grounding | `BingGroundingTool` | Web search (requires connection) |

| Azure AI Search | `AzureAISearchTool` | Search your indexes |

| Function Calling | `FunctionTool` | Call your Python functions |

| OpenAPI | `OpenApiTool` | Call REST APIs |

| MCP | `McpTool` | Model Context Protocol servers |

| Memory Search | `MemorySearchTool` | Search agent memory stores |

| SharePoint | `SharepointGroundingTool` | Search SharePoint content |


See references/tools.md for all tool patterns.


Thread and Message Flow


python 
# 1. Create thread
thread = client.agents.threads.create()

# 2. Add message
client.agents.messages.create(
    thread_id=thread.id,
    role="user",
    content="What's the weathe

🎯 Best For

  • UI designers
  • Product designers
  • Claude users
  • Software engineers
  • Development teams

💡 Use Cases

  • Generating component mockups
  • Creating design system tokens
  • Python code quality enforcement
  • Dependency management

📖 How to Use This Skill

  1. 1

    Install the Skill

    Copy the install command from the Terminal tab and run it. The SKILL.md file downloads to your local skills directory.

  2. 2

    Load into Your AI Assistant

    Open Claude and reference the skill. Paste the SKILL.md content or use the system prompt tab.

  3. 3

    Apply Azure Ai Projects Py to Your Work

    Open your project in the AI assistant and ask it to apply the skill. Start with a small module to verify the output quality.

  4. 4

    Review and Refine

    Review AI suggestions before committing. Run tests, check for regressions, and iterate on the skill output.

❓ Frequently Asked Questions

Does this work with Figma?

Some design skills integrate with Figma plugins. Check the Works With section for supported tools.

Is Azure Ai Projects Py compatible with Cursor and VS Code?

Yes — this skill works with any AI coding assistant including Cursor, VS Code with Copilot, and JetBrains IDEs.

Do I need specific dependencies for Azure Ai Projects Py?

Check the install command and Works With section. Most code skills only require the AI assistant and your codebase.

How do I install Azure Ai Projects Py?

Copy the install command from the Terminal tab and run it. The skill downloads to ./skills/azure-ai-projects-py/SKILL.md, ready to use.

Can I customize this skill for my team?

Absolutely. Edit the SKILL.md file to add team-specific instructions, examples, or workflows.

⚠️ Common Mistakes to Avoid

Skipping usability testing

AI-generated designs should be validated with real users before development.

Skipping validation

Always test AI-generated code changes, even for simple refactors.

Missing dependency updates

Check if the skill requires updated dependencies or new packages.

🔗 Related Skills

agent-framework-azure-ai-py Agent Framework Azure Ai Pyastropy astropyasync-python-patterns Async Python Patternsazure-ai-voicelive-py Azure Ai Voicelive Pyazure-cosmos-db-py Azure Cosmos Db Pyazure-functions Azure Functions