[Automated][azure-resource-manager] Document experimental Agent base type feature

## Summary Adds documentation for the new experimental Agent base type feature introduced in the `@azure-tools/typespec-azure-resource-manager` library. ## Changes ### How-to Guide (`resource-type.md`) - Added new "Agent Resources (Experimental)" section explaining the Agent template, deployment models (Appliance/Platform), and required child resources (Conversation, Response) - Added bullet point in "Choosing a Resource Type" section linking to the new agent docs - Includes a minimal Platform deployment model example following the canonical sample ### Rule Documentation - Fixed `arm-agent-base-type-child-resources.md` examples to use proper template parameters (`AgentDefinitionPlatform<true, true>`, `AgentPropertiesPlatform<MyDefinition>`) and include `using` statements and suppress directives - Fixed `arm-agent-base-type-lifecycle-operations.md` examples to include `using` statements and suppress directives ### Knowledge Base - Added "Agent Base Types (Experimental)" section documenting the feature's templates, deployment models, decorators, linting rules, and canonical sample path - Added agent sample path to the Sample Paths section ### Metadata - Updated `azure-resource-manager.meta.json` checkpoint commit > Generated by [Documentation Update Agent](https://github.com/Azure/typespec-azure/actions/runs/27947736884/agentic_workflow) · ● 19.3M · [◷](https://github.com/search?q=repo%3AAzure%2Ftypespec-azure+%22gh-aw-workflow-id%3A+doc-update%22&type=pullrequests) <!-- gh-aw-agentic-workflow: Documentation Update Agent, engine: copilot, model: claude-opus-4.6, id: 27947736884, workflow_id: doc-update, run: https://github.com/Azure/typespec-azure/actions/runs/27947736884 --> <!-- gh-aw-workflow-id: doc-update --> --- > [!NOTE] > This was originally intended as a pull request, but GitHub Actions is not permitted to create or approve pull requests in this repository. > The changes have been pushed to branch `docs/arm-agent-base-type-documentation-0e8205eb0fc5a5f6`. > > **[Click here to create the pull request](https://github.com/Azure/typespec-azure/compare/main...docs/arm-agent-base-type-documentation-0e8205eb0fc5a5f6?expand=1&title=%5BAutomated%5D%5Bazure-resource-manager%5D%20Document%20experimental%20Agent%20base%20type%20feature)** To fix the permissions issue, go to **Settings** → **Actions** → **General** and enable **Allow GitHub Actions to create and approve pull requests**. See also: [gh-aw FAQ](https://github.github.com/gh-aw/reference/faq/#why-is-my-create-pull-request-workflow-failing-with-github-actions-is-not-permitted-to-create-or-approve-pull-requests) <details><summary>Show patch preview (243 of 243 lines)</summary> ```diff From da2ac93ae7684be17840a7c00eccfa7a8d191047 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com> Date: Mon, 22 Jun 2026 11:10:42 +0000 Subject: [PATCH] docs(azure-resource-manager): add Agent base type documentation Add how-to documentation for the new experimental Agent base type feature: - New 'Agent Resources (Experimental)' section in resource-type.md - Fix rule doc examples to use proper template parameters - Update knowledge base with Agent base type patterns and sample path Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- .../knowledge/azure-resource-manager.md | 15 +++++ .../azure-resource-manager.meta.json | 4 +- .../docs/docs/howtos/ARM/resource-type.md | 62 +++++++++++++++++++ .../arm-agent-base-type-child-resources.md | 24 +++++-- ...rm-agent-base-type-lifecycle-operations.md | 6 ++ 5 files changed, 103 insertions(+), 8 deletions(-) diff --git a/eng/scripts/doc-updater/knowledge/azure-resource-manager.md b/eng/scripts/doc-updater/knowledge/azure-resource-manager.md index a34925fc..2695b502 100644 --- a/eng/scripts/doc-updater/knowledge/azure-resource-manager.md +++ b/eng/scripts/doc-updater/knowledge/azure-resource-manager.md @@ -54,6 +54,7 @@ Canonical ARM samples are under `packages/samples/specs/resource-manager/`: - `resource-types/extension/` — ExtensionResource multi-scope - `resource-types/specific-extension/` — ExternalResource targets - `resource-types/singleton/` — @singleton +- `resource-types/agent/` — Agent base type (Appliance and Platform) - `resource-types/virtual-resource/` — @armVirtualResource - `resource-types/location/` — ArmLocationResource parent - `resource-types/private-endpoints/` — PrivateEndpointConnection @@ -101,6 +102,20 @@ All standard envelope properties (`EntityTagProperty`, `ExtendedLocationProperty `ResourceNameParameter` has a `NamePattern` template parameter with default value `"^[a-zA-Z0-9-]{3,24}$"`. ... (truncated) ``` </details>