[azure-ai-projects] Add basic Agent Insights sample

[seangayler-msft]

Description

Adds one basic synchronous Agent Insights sample for the azure-ai-projects 2.6.0 preview API.

The required Agent Insights SDK changes are available on main through #48870.

Sample behavior

• Deletes an existing monitor for the selected test agent so an interrupted earlier run does not block the sample.
• Creates a monitor with scheduled generation disabled.
• Retrieves and lists the monitor.
• Deletes the created monitor in a finally block.
• Warns that deleting a monitor also deletes its runs, insights, and state.

No additional SDK patch is needed. The existing beta operation patch adds the Agent Insights preview feature header.

Validation

• Black formatting check
• Mypy check for the new sample
• Pylint checks for the sample and test wiring
• Sample lifecycle exercised with a fake client
• GPT-5.6 Sol review with no actionable findings

Test note

The sample folder is registered with the sample test framework and its LLM validation mapping. Recorded execution is explicitly skipped until an HTTP recording is available.

[azure-pipelines]

Azure Pipelines:
11 pipeline(s) were filtered out due to trigger conditions.
There may be pipelines that require an authorized user to comment /azp run to run.

[Copilot]

🟢 Approval recommended

The reviewed changes have no unresolved issues blocking approval.

Pull request overview

Adds a synchronous Agent Insights sample demonstrating a safe monitor lifecycle.

Changes:

• Demonstrates monitor creation, retrieval, listing, and cleanup.
• Registers sample testing and LLM validation.
• Documents the sample in the changelog.

File summaries

File	Description
sdk/ai/azure-ai-projects/tests/samples/test_samples.py	Registers the sample, pending an HTTP recording.
sdk/ai/azure-ai-projects/tests/samples/llm_instructions.py	Adds Agent Insights output validation mapping.
sdk/ai/azure-ai-projects/samples/agent_insights/sample_agent_insights_basic.py	Implements the monitor lifecycle sample.
sdk/ai/azure-ai-projects/CHANGELOG.md	Announces the new sample.

Review details

• Files reviewed: 4/4 changed files
• Comments generated: 0
• Review effort level: Balanced

---

💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.

[azure-pipelines]

Azure Pipelines:
Successfully started running 1 pipeline(s).
10 pipeline(s) were filtered out due to trigger conditions.
There may be pipelines that require an authorized user to comment /azp run to run.