Repository navigation
Add Kore AI Artemis CLI extension - #10544
Naga Nandyala (naga-nandyala) merged 9 commits into
Conversation
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 03025721-bce8-4b17-af2c-e7f7a413bacf
|
Azure Pipelines: There may be pipelines that require an authorized user to comment /azp run to run. |
|
/azp run |
|
Azure Pipelines: Successfully started running 2 pipeline(s). |
There was a problem hiding this comment.
🟡 Changes recommended
The organization and workspace create examples fail argument parsing because they include read-only subscriptionStatus and need corrected SaaS resource and subscription IDs.
1 open issue
What changed in this PR
Adds the preview koreai-artemis extension, integrating Kore.ai Artemis management into Azure CLI through az artemis.
Changes:
- Adds organization and workspace management commands using API version
2026-07-01-preview. - Adds SaaS activation, linking, and workspace-detail operations, with long-running operation support.
- Adds extension packaging, installation examples, and an offline command-help smoke test.
Paths below are relative to src/koreai-artemis/.
| File | Description |
|---|---|
setup.py |
Defines extension packaging and initial version. |
setup.cfg |
Adds a configuration placeholder. |
README.md |
Documents installation and basic usage. |
HISTORY.rst |
Records the initial release. |
azext_koreai_artemis/tests/latest/test_koreai_artemis.py |
Adds command-help smoke coverage. |
azext_koreai_artemis/tests/latest/__init__.py |
Initializes the latest test package. |
azext_koreai_artemis/tests/__init__.py |
Initializes the test package. |
azext_koreai_artemis/custom.py |
Adds custom-command scaffolding. |
azext_koreai_artemis/commands.py |
Adds a custom command-registration hook. |
azext_koreai_artemis/azext_metadata.json |
Declares preview status and minimum CLI version. |
azext_koreai_artemis/aaz/latest/artemis/organization/workspace/_wait.py |
Adds workspace condition waiting. |
azext_koreai_artemis/aaz/latest/artemis/organization/workspace/_update.py |
Adds workspace updates using GET then PUT. |
azext_koreai_artemis/aaz/latest/artemis/organization/workspace/_show.py |
Retrieves a workspace resource. |
azext_koreai_artemis/aaz/latest/artemis/organization/workspace/_show_details.py |
Retrieves workspace details, including projects. |
azext_koreai_artemis/aaz/latest/artemis/organization/workspace/_list.py |
Lists workspaces with pagination. |
azext_koreai_artemis/aaz/latest/artemis/organization/workspace/_list_linked_saas.py |
Lists linked SaaS resources. |
azext_koreai_artemis/aaz/latest/artemis/organization/workspace/_link_saas.py |
Links SaaS resources to a workspace. |
azext_koreai_artemis/aaz/latest/artemis/organization/workspace/_delete.py |
Adds workspace deletion with confirmation. |
azext_koreai_artemis/aaz/latest/artemis/organization/workspace/_create.py |
Adds workspace creation. |
azext_koreai_artemis/aaz/latest/artemis/organization/workspace/__init__.py |
Imports workspace commands. |
azext_koreai_artemis/aaz/latest/artemis/organization/workspace/__cmd_group.py |
Registers the workspace command group. |
azext_koreai_artemis/aaz/latest/artemis/organization/_wait.py |
Adds organization condition waiting. |
azext_koreai_artemis/aaz/latest/artemis/organization/_update.py |
Adds organization updates using GET then PUT. |
azext_koreai_artemis/aaz/latest/artemis/organization/_show.py |
Retrieves an organization resource. |
azext_koreai_artemis/aaz/latest/artemis/organization/_list.py |
Lists organizations by subscription or resource group. |
azext_koreai_artemis/aaz/latest/artemis/organization/_list_workspaces.py |
Lists ARM-managed and Kore-only workspaces. |
azext_koreai_artemis/aaz/latest/artemis/organization/_delete.py |
Adds organization deletion with confirmation. |
azext_koreai_artemis/aaz/latest/artemis/organization/_create.py |
Creates organizations with a default workspace. |
azext_koreai_artemis/aaz/latest/artemis/organization/__init__.py |
Imports organization commands. |
azext_koreai_artemis/aaz/latest/artemis/organization/__cmd_group.py |
Registers the organization command group. |
azext_koreai_artemis/aaz/latest/artemis/_activate_saas.py |
Activates a marketplace SaaS resource. |
azext_koreai_artemis/aaz/latest/artemis/__init__.py |
Imports the root group and activation command. |
azext_koreai_artemis/aaz/latest/artemis/__cmd_group.py |
Registers the preview artemis group. |
azext_koreai_artemis/aaz/latest/__init__.py |
Initializes the latest command package. |
azext_koreai_artemis/aaz/__init__.py |
Initializes the generated command package. |
azext_koreai_artemis/_params.py |
Adds a custom argument-loading hook. |
azext_koreai_artemis/_help.py |
Adds custom help scaffolding. |
azext_koreai_artemis/__init__.py |
Connects the extension loader to generated commands. |
Review effort: Balanced
| """Create an Organization (long-running). | ||
|
|
||
| :example: Organizations_Create | ||
| az artemis organization create --resource-group contoso-rg --organization-name contoso-org --location eastus2euap --tags "{environment:production}" --partner-properties "{organization-name:'Contoso AI Platform',billing-email:billing@contoso.com,owner-email:admin@contoso.com,default-workspace:{name:'my first workspace',product:aiforwork,marketplace-details:[{subscriptionStatus:Subscribed,offer-details:{offer-id:kore-ai-platform,plan-id:business-monthly,publisher-id:kore-ai,plan-name:'Business Monthly',term-id:1m,term-unit:P1M},subscription-id:/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso-rg/providers/Microsoft.SaaS/resources/kore-ai-saas}]}}" --user "{first-name:Jane,last-name:Doe,email-address:jane.doe@contoso.com,upn:jane.doe@contoso.onmicrosoft.com,phone-number:+1-425-555-0100}" --company-details "{company-name:'Contoso Ltd.',country:US,domain:contoso.com,business-type:Technology,number-of-employees:500}" |
Restore the generated string argument with GUID pattern validation after removing the same-version REST schema change. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 03025721-bce8-4b17-af2c-e7f7a413bacf
|
/azp run |
|
Azure Pipelines: Successfully started running 2 pipeline(s). |
Add the artemis service name and exclude the wait-command rule because the activate action has no pollable GET resource from which AAZ can generate a wait command. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 03025721-bce8-4b17-af2c-e7f7a413bacf
|
/azp run |
|
Azure Pipelines: Successfully started running 2 pipeline(s). |
…urce-id Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 03025721-bce8-4b17-af2c-e7f7a413bacf
|
/azp run |
|
Azure Pipelines: Successfully started running 2 pipeline(s). |
Naga Nandyala (naga-nandyala)
left a comment
There was a problem hiding this comment.
Thanks. The implementation and companion AAZ alignment look good, and the create-example issue is fixed. Before approving this new extension:
- Functional tests: the current test only exercises help. Please cover organization/workspace create, show, list, update and delete, including updates preserving existing configuration. Add SaaS activation/linking tests covering asynchronous completion and
--no-wait. Where Marketplace prerequisites prevent normal playback coverage, providelive_onlyscenarios with passing live results and retain offline request/polling tests. - Naming (you asked for input): these are suggestions:
az artemisdoesn't match the extension namekoreai-artemis, and "artemis" alone is generic at the top level; consider a brand-qualified group such asaz koreai artemis.- Consider noun-verb instead of a root-level verb, e.g.
az artemis saas activateinstead ofactivate-saas. organization list-workspacesvsorganization workspace list, andworkspace show-detailsvsworkspace show, look similar. Please clarify the difference in help text or consolidate.
- Housekeeping: update the dependency reference to merged REST PR #47279 (#47809 was closed), and add a docs URL in
service_name.json.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 03025721-bce8-4b17-af2c-e7f7a413bacf
|
/azp run |
|
Azure Pipelines: Successfully started running 2 pipeline(s). |
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 03025721-bce8-4b17-af2c-e7f7a413bacf
|
/azp run |
|
Azure Pipelines: Successfully started running 2 pipeline(s). |
|
Please fix CI issues |
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 03025721-bce8-4b17-af2c-e7f7a413bacf
|
/azp run |
|
Azure Pipelines: Successfully started running 2 pipeline(s). |
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 03025721-bce8-4b17-af2c-e7f7a413bacf
|
/azp run |
|
Azure Pipelines: Successfully started running 2 pipeline(s). |
|
Thanks for the thorough update. The |
|
This needs rework/fixing. Moving to next milestone (Dec 2026) |
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 03025721-bce8-4b17-af2c-e7f7a413bacf
|
/azp run |
|
Azure Pipelines: Successfully started running 2 pipeline(s). |
|
[Release] Update index.json for extension [ koreai-artemis-1.0.0b1 ] : https://dev.azure.com/msazure/One/_build/results?buildId=191428683&view=results |

Summary
Add the preview
koreai-artemisAzure CLI extension for the Kore.ai Artemis management service.koreai-artemisaz artemis2026-07-01-preview1.0.0b1Naming review requested
Please review these intentional public CLI choices:
koreai-artemisaz artemisactivate-saasorganization list-workspacesorganization workspace show-details--saas-resource-idsDependencies
Validation
1 passed)activate-saasandlink-saasexpose--no-wait, but nowaitcommand is generated because these action resources do not provide a GET operation with provisioning state.