Skip to content

Conversation

@radubulboaca
Copy link
Contributor

Add get-csaiagents

@learn-build-service-prod
Copy link

Learn Build status updates of commit 1263d95:

⚠️ Validation status: warnings

File Status Preview URL Details
teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md ⚠️Warning View (teams-ps) Details
teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md ✅Succeeded View (teams-ps)

teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md

  • Line 0, Column 0: [Warning: PSMD2Yaml_InconsistentCmdletsInModule] Inconsistent cmdlets found in module: MicrosoftTeams. 1 cmdlets in the module folder but not listed in the module file: Get-CsAiAgents.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@learn-build-service-prod
Copy link

Learn Build status updates of commit 3eb4e8a:

✅ Validation status: passed

File Status Preview URL Details
teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md ✅Succeeded View (teams-ps)
teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md ✅Succeeded View (teams-ps)

For more details, please refer to the build report.

@learn-build-service-prod
Copy link

Learn Build status updates of commit 285833d:

✅ Validation status: passed

File Status Preview URL Details
teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md ✅Succeeded View (teams-ps)
teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md ✅Succeeded View (teams-ps)

For more details, please refer to the build report.

Copy link
Member

@nomorephones nomorephones left a comment

Choose a reason for hiding this comment

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

  1. The synopsis doesn't articulate the purpose of ProviderID. Suggest amendind with "...in the tenant that match with the ProviderID.

  2. In the spec, ProviderID is an array allowing for a return of Agents across multiple ProviderIDs. If that's supported in this version, suggest including an example.

  3. In the past, I've seen the output of cmdlets as a complex object type. For example, with CsTagsTemplate the output is a "Microsoft.Rtc.Management.Hosted.CallQueue.Models.CallQueue". While the example is definitely appreciated, I'm curious if this still follows the convention.

  4. If the GUIDs here are from a real environment, suggest bit-shifting a character by a value or two to obfuscate it.

@learn-build-service-prod
Copy link

Learn Build status updates of commit 8c384b3:

✅ Validation status: passed

File Status Preview URL Details
teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md ✅Succeeded View (teams-ps)
teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md ✅Succeeded View (teams-ps)

For more details, please refer to the build report.

@learn-build-service-prod
Copy link

Learn Build status updates of commit dc85378:

✅ Validation status: passed

File Status Preview URL Details
teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md ✅Succeeded View (teams-ps)
teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md ✅Succeeded View (teams-ps)

For more details, please refer to the build report.

@radubulboaca
Copy link
Contributor Author

The synopsis doesn't articulate the purpose of ProviderID. Suggest amendind with "...in the tenant that match with the ProviderID.

Thanks, updated.

In the spec, ProviderID is an array allowing for a return of Agents across multiple ProviderIDs. If that's supported in this version, suggest including an example.

Thanks, added another example

In the past, I've seen the output of cmdlets as a complex object type. For example, with CsTagsTemplate the output is a "Microsoft.Rtc.Management.Hosted.CallQueue.Models.CallQueue". While the example is definitely appreciated, I'm curious if this still follows the convention.

We're a bit uncertain of what the namespace will be for this one. I'll keep this as is for now and make an update once I verify it

If the GUIDs here are from a real environment, suggest bit-shifting a character by a value or two to obfuscate it.

Thanks, already randomized some of the fields, I randomized more of them now

@learn-build-service-prod
Copy link

Learn Build status updates of commit b5200f9:

✅ Validation status: passed

File Status Preview URL Details
teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md ✅Succeeded View (teams-ps)
teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md ✅Succeeded View (teams-ps)

For more details, please refer to the build report.

@learn-build-service-prod
Copy link

Learn Build status updates of commit 8235aca:

✅ Validation status: passed

File Status Preview URL Details
teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md ✅Succeeded View (teams-ps)
teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md ✅Succeeded View (teams-ps)

For more details, please refer to the build report.

Copy link
Contributor

@sdwheeler sdwheeler left a comment

Choose a reason for hiding this comment

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

See my suggested changes and fix the parameter metadata.


### Example 1 - Get AI agents from a provider

```
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
```
```powershell

Copy link
Contributor Author

Choose a reason for hiding this comment

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

ACK, updated


This example gets the AI Agents from ProviderId "9d8f559b-5de4-46a4-902a-ad4271e83efa" that are compatible with Teams Interactive Voice Response (IVR). The output of the Get-CsAiAgents cmdlet is a list of AI Agents, with parameters such as `BotHandle`, `MsaAppId`, `MsaAppTenantId` and more.

```
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
```
```Output
```

Copy link
Contributor Author

Choose a reason for hiding this comment

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

ACK, updated

Get-CsAiAgents -IsTeamsIvrEnabled -ProviderId "9d8f559b-5de4-46a4-902a-ad4271e83efa"
```

This example gets the AI Agents from ProviderId "9d8f559b-5de4-46a4-902a-ad4271e83efa" that are compatible with Teams Interactive Voice Response (IVR). The output of the Get-CsAiAgents cmdlet is a list of AI Agents, with parameters such as `BotHandle`, `MsaAppId`, `MsaAppTenantId` and more.
Copy link
Contributor

Choose a reason for hiding this comment

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

This paragraph needs to be moved before or after the code blocks. It can't be between them.


## DESCRIPTION

> [!CAUTION]
Copy link
Contributor

Choose a reason for hiding this comment

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

This should be a NOTE unless it can cause damage.

Suggested change
> [!CAUTION]
> [!NOTE]

Copy link
Contributor Author

Choose a reason for hiding this comment

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

ACK; updated


### Example 2 - Get AI agents from mulitple providers

```
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
```
```powershell

Comment on lines 69 to 82
Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: true
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Copy link
Contributor

Choose a reason for hiding this comment

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

This is the format of the new metadata. You didn't use the old platyPS to create this.

@learn-build-service-prod
Copy link

Learn Build status updates of commit c17a710:

✅ Validation status: passed

File Status Preview URL Details
teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md ✅Succeeded View (teams-ps)
teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md ✅Succeeded View (teams-ps)

For more details, please refer to the build report.

@learn-build-service-prod
Copy link

Learn Build status updates of commit 300193f:

✅ Validation status: passed

File Status Preview URL Details
teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md ✅Succeeded View (teams-ps)
teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md ✅Succeeded View (teams-ps)

For more details, please refer to the build report.

Copy link
Contributor

@sdwheeler sdwheeler left a comment

Choose a reason for hiding this comment

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

OK, this looks good now.

@pavellatif pavellatif added the Sign off The pull request is ready to be reviewed and merged by PubOps label Nov 6, 2025
@Ruchika-mittal01 Ruchika-mittal01 self-assigned this Nov 6, 2025
@Ruchika-mittal01 Ruchika-mittal01 added the In review PubOps is reviewing the pull request label Nov 6, 2025
@learn-build-service-prod
Copy link

Learn Build status updates of commit 2fa1333:

✅ Validation status: passed

File Status Preview URL Details
teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md ✅Succeeded View (teams-ps)
teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md ✅Succeeded View (teams-ps)

For more details, please refer to the build report.

@Ruchika-mittal01 Ruchika-mittal01 added the PubOps fixes PubOps has fixed some issues in this PR. label Nov 6, 2025
@learn-build-service-prod
Copy link

Learn Build status updates of commit 432242a:

✅ Validation status: passed

File Status Preview URL Details
teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md ✅Succeeded View (teams-ps)
teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md ✅Succeeded View (teams-ps)

For more details, please refer to the build report.

@Ruchika-mittal01 Ruchika-mittal01 merged commit 7680386 into MicrosoftDocs:main Nov 6, 2025
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

In review PubOps is reviewing the pull request Microsoft submitter PubOps fixes PubOps has fixed some issues in this PR. Sign off The pull request is ready to be reviewed and merged by PubOps

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants