Skip to content

Commit 1382642

Browse files
authored
Merge pull request #314929 from MicrosoftDocs/main
4/20/2026 OOB Publishing
2 parents ec704fb + 9307789 commit 1382642

175 files changed

Lines changed: 14517 additions & 17 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -158,3 +158,4 @@ articles/planetary-computer/geocatalog_configs/umbra-sar-ships/stac.json
158158
articles/planetary-computer/geocatalog_configs/umbra-sar-ships/tile-settings.json
159159
articles/planetary-computer/helper-content/collection-config-scraper.py
160160
articles/planetary-computer/helper-content/generate_collection_docs.py
161+
.github/copilot-instructions.md

articles/app-testing/load-testing/how-to-configure-load-test-cicd.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -296,7 +296,7 @@ Update your Azure Pipelines workflow to run a load test for your Azure load test
296296
```
297297
298298
Optionally, you can pass parameters or secrets to the load test by using the `env` or `secrets` property.
299-
Set *`waitForCompletion: false`* to if you want to proceed without waiting for the load test run to complete.
299+
Set *`waitForCompletion: false`* if you want to proceed without waiting for the load test run to complete.
300300
301301
1. Use the `publish` task to publish the test results as artifacts in your Azure Pipelines workflow run.
302302
@@ -350,7 +350,7 @@ Update your GitHub Actions workflow to run a load test for your Azure load testi
350350
```
351351
352352
Optionally, you can pass parameters or secrets to the load test by using the `env` or `secrets` property.
353-
Set *`waitForCompletion: false`* to if you want to proceed without waiting for the load test run to complete.
353+
Set *`waitForCompletion: false`* if you want to proceed without waiting for the load test run to complete.
354354
355355
1. Use the `actions/upload-artifact` action to publish the test results as artifacts in your GitHub Actions workflow run.
356356

articles/app-testing/load-testing/how-to-test-secured-endpoints.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -246,11 +246,8 @@ When you run your load test, Azure Load Testing retrieves the client certificate
246246
For Locust-based tests, you can retrieve the certificate and use it in your tests script. The certificate configured in the load test configuration are available in the `ALT_CERTIFICATES_DIR`.
247247

248248
```Python
249-
endpoint = os.getenv("endpoint") or "localhost"
250249
cert_dir = os.getenv("ALT_CERTIFICATES_DIR")
251250
252-
base_url = "https://" + endpoint
253-
254251
key_path = "client.key.pem"
255252
crt_path = "client.crt.pem"
256253

articles/azure-netapp-files/object-rest-api-access-configure.md

Lines changed: 19 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,9 +15,26 @@ Azure NetApp Files supports access to objects with the [object REST API](object-
1515

1616
This article describes how to configure object REST API access and walks you through the two supported certificate workflows. Choose the workflow that best matches your security and operational requirements.
1717

18-
## Register the feature
18+
## Register the feature
1919

20-
The object REST API feature in Azure NetApp Files is currently in preview. You must submit a [waitlist request](https://aka.ms/ANF-object-REST-API-signup) to use this feature. Activation takes approximately one week, and you receive an email notification once the enrollment is complete.
20+
The object REST API feature in Azure NetApp Files is currently in preview. You need to register the feature before using it for the first time.
21+
22+
1. Register the feature:
23+
24+
```azurepowershell-interactive
25+
Register-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFEnableObjectRESTAPI
26+
```
27+
28+
2. Check the status of the feature registration:
29+
30+
> [!NOTE]
31+
> The **RegistrationState** may be in the `Registering` state for up to 60 minutes before changing to`Registered`. Wait until the status is **Registered** before continuing.
32+
33+
```azurepowershell-interactive
34+
Get-AzProviderFeature -ProviderNamespace Microsoft.NetApp -FeatureName ANFEnableObjectRESTAPI
35+
```
36+
37+
You can also use [Azure CLI commands](/cli/azure/feature) `az feature register` and `az feature show` to register the feature and display the registration status.
2138
2239
## Create the self-signed certificate
2340

articles/cost-management-billing/understand/review-enterprise-agreement-bill.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ ms.reviewer: v-salin
66
ms.service: cost-management-billing
77
ms.subservice: enterprise
88
ms.topic: tutorial
9-
ms.date: 09/22/2025
9+
ms.date: 04/20/2026
1010
ms.author: v-salin
1111
---
1212
# Understand your Azure Enterprise Agreement bill
Lines changed: 206 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,206 @@
1+
---
2+
title: Advanced investigation patterns in Microsoft Discovery
3+
description: Learn advanced patterns for structuring investigations with the Discovery Engine, including fully deterministic investigations, guided exploration, and fully autonomous research.
4+
author: hectoralinares
5+
ms.author: hectorl
6+
ms.service: azure
7+
ms.topic: concept-article
8+
ms.date: 03/30/2026
9+
10+
#CustomerIntent: As a researcher or scientist, I want to understand advanced ways to structure my investigations so that I can match the level of autonomy to the complexity of my research.
11+
---
12+
13+
# Advanced investigation patterns
14+
15+
The [trust and basic investigation patterns](concept-trust-basic-investigation-patterns.md) article introduced the spectrum from structured tasks to broad objectives. This article goes deeper into three advanced patterns that represent distinct approaches to working with the [Discovery Engine](concept-discovery-engine.md). Cognition is goal-seeking, it continuously plans, executes, and adapts to drive an investigation toward its research objective, each pattern represents a different way to balance your control against cognition's autonomy. The right pattern depends on how well you understand the problem upfront.
16+
17+
## Pattern 1: Deterministic investigation
18+
19+
In a deterministic investigation, you define every task, assign specific agents, set up all dependencies, and write detailed validation requirements. Cognition's role is execution, validation, and retry management. You control the *what* and *how*. Cognition handles the *when* and *whether it's good enough*.
20+
21+
### When to use this pattern
22+
23+
- You have a known, repeatable protocol (for example, a molecular screening pipeline)
24+
- You want consistent, reproducible results across investigations
25+
- The agents and tools for each step are well understood
26+
- Quality gates between steps are critical
27+
28+
### How to set it up
29+
30+
1. **Create all tasks upfront** with titles, descriptions, and validation requirements.
31+
2. **Set dependencies** so tasks execute in the correct order. Tasks without dependencies can run in parallel.
32+
3. **Guide agent selection** for each task by adding a comment that specifies which agent to use and why. Cognition reads comments when selecting agents. If you leave no guidance, cognition selects the agent based on its assessment of capabilities.
33+
4. **Write detailed validation requirements** for each task. In a deterministic investigation, validation requirements are your quality gates. Be specific about what each step should produce.
34+
35+
### Example
36+
37+
```
38+
Parent: "Screen 5 candidate molecules for drug target Y"
39+
40+
Task 1: "Retrieve molecular structures from PubChem"
41+
Agent: blastAgent
42+
Depends on: (none)
43+
Validation: "Structures retrieved for all 5 candidates in FASTA format"
44+
45+
Task 2: "Compute binding affinity predictions"
46+
Agent: graphormerAgent
47+
Depends on: Task 1
48+
Validation: "Binding affinity predicted for each candidate with target Y"
49+
"Results include predicted energy values in kcal/mol"
50+
51+
Task 3: "Compute ADMET properties"
52+
Agent: rdkbasicAgent
53+
Depends on: Task 1
54+
Validation: "ADMET profile computed for all 5 candidates"
55+
"Properties include solubility, toxicity risk, and bioavailability"
56+
57+
Task 4: "Rank candidates and generate report"
58+
Agent: wordAgent
59+
Depends on: Task 2, Task 3
60+
Validation: "Ranking considers both binding affinity and ADMET properties"
61+
"Report includes a recommendation with supporting rationale"
62+
```
63+
64+
### What cognition does in this pattern
65+
66+
Even though you defined the full investigation, cognition still adds value:
67+
68+
- **Validation at each step**: If Task 2 produces results that don't meet your requirements, cognition retries before allowing Task 4 to start. This quality feedback loop is something you wouldn't get from running the same agents manually in sequence.
69+
- **Error recovery**: If a tool times out or returns an error, cognition can handle retries automatically.
70+
- **Parallel execution**: Tasks 2 and 3 both depend only on Task 1, so cognition runs them in parallel.
71+
- **Progress tracking**: You see the full execution history, validation comments, and results for each step.
72+
73+
### Considerations
74+
75+
- This pattern requires more upfront work to set up.
76+
- If you need to change the investigation mid-run, you modify individual tasks rather than having cognition adapt on its own.
77+
- You can reuse the same task structure across investigations using the same pattern. Consider building templates for investigations you run regularly.
78+
79+
## Pattern 2: Guided exploration
80+
81+
In guided exploration, you define the major phases of your research but leave the details to cognition. You create parent tasks for each phase with broad validation requirements. Cognition decomposes each phase into child tasks, selects agents, and manages execution within the boundaries you set.
82+
83+
### When to use this pattern
84+
85+
- You know the general approach but not the exact steps
86+
- Different phases of the work require different levels of detail
87+
- You want cognition to make tactical decisions while you control strategic direction
88+
- The problem is understood that you can define phases, but the specific methods within each phase should be flexible
89+
90+
### How to set it up
91+
92+
1. **Create parent tasks** for each major phase of your research.
93+
2. **Write validation requirements at the phase level**, describing what each phase should produce rather than how it should get there.
94+
3. **Set dependencies between phases** where one phase needs results from another.
95+
4. **Leave agent selection to cognition** for most tasks. If you have a strong preference for a specific phase, add a comment to the task specifying which agent to use.
96+
5. **Enable Discovery Mode** and let cognition create child tasks within each phase.
97+
98+
### Example
99+
100+
```
101+
Phase 1: "Identify promising molecular targets for [disease]"
102+
Depends on: (none)
103+
Validation: "At least 3 candidate targets identified"
104+
"Each target includes supporting evidence from literature"
105+
106+
Phase 2: "Characterize binding properties of top candidates"
107+
Depends on: Phase 1
108+
Validation: "Binding properties computed for all candidates from Phase 1"
109+
"Analysis includes at least binding affinity and selectivity"
110+
111+
Phase 3: "Recommend lead candidates with rationale"
112+
Depends on: Phase 2
113+
Validation: "Recommendation narrows to 1-2 lead candidates"
114+
"Rationale references binding data and target relevance"
115+
```
116+
117+
### What cognition does in this pattern
118+
119+
Cognition takes ownership of the tactical decisions within each phase:
120+
121+
- **Decomposes phases into child tasks** based on what it determines is needed
122+
- **Selects agents and tools** for each child task
123+
- **Creates dependencies** between child tasks within a phase when results from one inform another
124+
- **Validates child task results** against the phase-level requirements you defined
125+
- **Synthesizes child task results** into the phase-level deliverable
126+
127+
### Considerations
128+
129+
- You see child tasks appear that you didn't explicitly create. Review them periodically to verify cognition is headed in the right direction.
130+
- Phase-level validation requirements need to be specific enough that cognition can evaluate results, but broad enough that different approaches can satisfy them.
131+
- If cognition's decomposition doesn't match your expectations, add comments to the parent task with guidance. Cognition reads comments and adjusts its approach.
132+
133+
## Pattern 3: Autonomous research
134+
135+
In autonomous research, you provide a single high-level objective and let cognition handle everything. Cognition decomposes the objective, creates the full task hierarchy, selects agents, manages execution, and synthesizes results. You check in periodically to review progress and provide strategic feedback.
136+
137+
### When to use this pattern
138+
139+
- You're exploring a new problem space without a predetermined approach
140+
- The research question is broad and could be addressed from multiple angles
141+
- You want to see what the engine discovers without constraining the approach
142+
- You're willing to invest time upfront (hours to days) while cognition explores
143+
144+
### How to set it up
145+
146+
1. **Create a single root task** with a clear but broad objective.
147+
2. **Write validation requirements** that describe what a successful outcome looks like at the highest level.
148+
3. **Enable Discovery Mode** and step away.
149+
4. **Check in periodically** (every few hours) to review the task tree cognition built and the results from completed tasks.
150+
5. **Provide feedback** through comments on tasks. Add new tasks if you want to steer cognition toward a specific direction.
151+
152+
### Example
153+
154+
```
155+
Root task: "Investigate the viability of repurposing existing
156+
antiviral compounds for [new disease target], considering
157+
binding mechanism, selectivity, and preliminary toxicity"
158+
159+
Validation: "Investigation covers at least 3 existing antiviral compounds"
160+
"Analysis includes binding mechanism characterization for each"
161+
"Preliminary toxicity assessment covers top candidates"
162+
"Final recommendation identifies the most promising candidate with rationale"
163+
```
164+
165+
### What cognition does in this pattern
166+
167+
This is where cognition operates with the most autonomy:
168+
169+
- **Plans the research strategy** by decomposing the objective into phases and tasks
170+
- **Identifies what data and tools you need** and creates tasks to acquire or run them
171+
- **Makes scientific judgment calls** about which approaches to pursue based on intermediate results
172+
- **Iterates** when early results suggest a different direction
173+
- **Aggregates findings** across multiple tasks into a coherent result for the root task
174+
175+
### Considerations
176+
177+
- This pattern requires the most patience. Cognition might explore approaches you wouldn't choose.
178+
- Results can be surprising. Cognition sometimes identifies connections or approaches that aren't obvious from a human planning perspective.
179+
- The quality of the root task description and validation requirements strongly influences the quality of the outcome. A vague objective produces vague results.
180+
- For broad investigations, expect cognition to create a significant number of child tasks. This is normal. Review the task tree periodically to remove subtasks that aren't useful.
181+
- Cognition's reasoning is influenced by the agents and tools available in your project. If the project only has one agent, cognition's options are limited regardless of the objective's breadth.
182+
183+
## Choosing the right pattern
184+
185+
> [!NOTE]
186+
> All patterns require that your project has agents with the right capabilities for the work. The Discovery Engine orchestrates agents, it doesn't replace them. Without specialized agents and tools, the engine has no more capability than a standalone reasoning model. The patterns differ in who decides which agent handles which task: you or cognition.
187+
188+
| Factor | Deterministic | Guided exploration | Autonomous |
189+
|--------|--------------|-------------------|------------|
190+
| **You know the exact steps** | Yes | Partially | No |
191+
| **Who selects agents** | You guide selection (via comments) | You guide phases, cognition selects within them | Cognition selects for all tasks |
192+
| **Upfront setup effort** | High | Medium | Low |
193+
| **Cognition autonomy** | Low (execute and validate) | Medium (decompose within phases) | High (plan and execute everything) |
194+
| **Reproducibility** | High | Medium | Lower |
195+
| **Time to first results** | Depends on investigation length | Moderate | Longer (exploration takes time) |
196+
| **Best for** | Known protocols, repeatable pipelines | Phased research with known direction | Exploratory, open-ended research |
197+
198+
You can also mix patterns within a single investigation. For example, use a deterministic investigation for a well-understood data preparation phase, then switch to guided exploration for the analysis phase where the best approach isn't clear.
199+
200+
## Related content
201+
202+
- [Trust relationship and basic investigation patterns](concept-trust-basic-investigation-patterns.md)
203+
- [Discovery Engine](concept-discovery-engine.md)
204+
- [Cognition overview](concept-cognition-overview.md)
205+
- [Tasks and investigations](concept-tasks-investigations.md)
206+
- [Build investigations with cognition](how-to-build-investigations-cognition.md)

0 commit comments

Comments
 (0)