From 7ea90504b4db76073de8f0a0d8b8caceea23c5fa Mon Sep 17 00:00:00 2001 From: Tina Manghnani Date: Fri, 5 Dec 2025 07:36:51 -0800 Subject: [PATCH] Add capability host creation instructions and update agent version Added instructions for creating an account-level capability host and updated the hosted agent version section to reflect changes in replica parameters. --- .../default/agents/concepts/hosted-agents.md | 20 +++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) diff --git a/articles/ai-foundry/default/agents/concepts/hosted-agents.md b/articles/ai-foundry/default/agents/concepts/hosted-agents.md index 8e282964e0..54846e1d5d 100644 --- a/articles/ai-foundry/default/agents/concepts/hosted-agents.md +++ b/articles/ai-foundry/default/agents/concepts/hosted-agents.md @@ -272,6 +272,22 @@ Before you create the agent, give your project's managed identity access to pull 1. Grant pull permissions by assigning the Container Registry Repository Reader role to your project's managed identity on the container registry. For detailed steps, see [Azure Container Registry roles and permissions](/azure/container-registry/container-registry-roles). +### Create account-level Capability Host + +Updating capability hosts is not supported. If you have existing capability host for your Foundry account, you must delete the existing one and recreate it with the property "enablePublicHostingEnvironment" set to true. + +```bash +curl --request PUT \ + --url 'https://management.azure.com/subscriptions/96aede12-2f73-41cb-b983-6d11a904839b/resourceGroups/arthfa-ncus/providers/Microsoft.CognitiveServices/accounts/arthfa-ncus/capabilityHosts/accountcaphost?api-version=2025-10-01-preview' \ + --header 'content-type: application/json' \ + --data '{ + "properties": { + "capabilityHostKind": "Agents", + "enablePublicHostingEnvironment": true + } +}' +``` + ### Create the hosted agent version Use the Azure AI Projects SDK to create and register your agent: @@ -383,8 +399,8 @@ The arguments for this code include: | `--agent-version` | ✅ | Foundry Tools hosted agent version | | `--name -n` | ✅ | Foundry Tools hosted agent name | | `--project-name` | ✅ | AI project name | -| `--min-replicas` | ✅ | Minimum number of replicas for horizontal scaling | -| `--max-replicas` | ✅ | Maximum number of replicas for horizontal scaling | +| `--min-replicas` | ❌ | Minimum number of replicas for horizontal scaling | +| `--max-replicas` | ❌ | Maximum number of replicas for horizontal scaling | Here's an example: