Skip to content

Add capability host creation instructions and update agent version #624

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
tinaem wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Add capability host creation instructions and update agent version #624

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 18 additions & 2 deletions articles/ai-foundry/default/agents/concepts/hosted-agents.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Copy link

Copilot AI Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The heading uses sentence case ("Capability Host") instead of the expected lowercase style for multi-word terms. According to Microsoft Writing Style Guide, headings should be in sentence case. This should be "Create account-level capability host" (with "capability host" in lowercase).

Suggested change
### Create account-level Capability Host
### Create account-level capability host

Copilot uses AI. Check for mistakes.

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.
Copy link

Copilot AI Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Extra space detected between "you" and "must" - should be a single space instead of two spaces.

Suggested change
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.
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.

Copilot uses AI. Check for mistakes.
Copy link

Copilot AI Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Missing article "an" before "existing capability host". The sentence should read "If you have an existing capability host for your Foundry account..."

Suggested change
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.
Updating capability hosts is not supported. If you have an existing capability host for your Foundry account, you must delete the existing one and recreate it with the property "enablePublicHostingEnvironment" set to true.

Copilot uses AI. Check for mistakes.

Copy link

Copilot AI Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The cURL command lacks introductory text explaining what the command does or when to use it. Consider adding a brief introduction before the code block, such as "To create the account-level capability host with public hosting enabled, use the following Azure REST API call:" This follows the pattern used elsewhere in the document (see lines 237-240, 293).

Suggested change
To create the account-level capability host with public hosting enabled, use the following Azure REST API call:

Copilot uses AI. Check for mistakes.
```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' \
Copy link

Copilot AI Dec 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This cURL example contains hardcoded subscription ID, resource group name, and account name that appear to be specific to a test environment ("arthfa-ncus"). These should be replaced with placeholders or generic example values to prevent confusion and potential security issues.

Consider using placeholders like:

  • {subscription-id} or your-subscription-id
  • {resource-group-name} or your-resource-group
  • {account-name} or your-foundry-account
Suggested change
--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' \
--url 'https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.CognitiveServices/accounts/{account-name}/capabilityHosts/accountcaphost?api-version=2025-10-01-preview' \

Copilot uses AI. Check for mistakes.
--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:
Expand Down Expand Up @@ -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:

Expand Down