Skip to content

Add Kore AI Artemis CLI extension - #10544

Merged
Naga Nandyala (naga-nandyala) merged 9 commits into
Azure:mainfrom
shiwanijain:kore-artemis-client-parity
Nov 16, 2026
Merged

Naga Nandyala (naga-nandyala) merged 9 commits into
Azure:mainfrom
shiwanijain:kore-artemis-client-parity

Conversation

@shiwanijain

@shiwanijain Shiwani (shiwanijain) commented Nov 2, 2026 •

Copy link
Copy Markdown
Member

Summary

Add the preview koreai-artemis Azure CLI extension for the Kore.ai Artemis management service.

  • extension name: koreai-artemis
  • top-level command group: az artemis
  • API version: 2026-07-01-preview
  • extension version: 1.0.0b1

Naming review requested

Please review these intentional public CLI choices:

  • extension name koreai-artemis
  • top-level group az artemis
  • root placement of activate-saas
  • organization list-workspaces
  • organization workspace show-details
  • parameter name --saas-resource-ids

Dependencies

Validation

  • generated from the AAZ models in Add Kore AI Artemis AAZ commands aaz#1154
  • Python compilation passed
  • offline command-help test passed (1 passed)
  • Azure CLI linter passed with no violations
  • custom pylint passed
  • pylint and flake8 style checks passed
  • wheel build passed

activate-saas and link-saas expose --no-wait, but no wait command is generated because these action resources do not provide a GET operation with provisioning state.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 03025721-bce8-4b17-af2c-e7f7a413bacf
Copilot AI balanced review requested due to automatic review settings November 2, 2026 06:21
@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
There may be pipelines that require an authorized user to comment /azp run to run.

@a0x1ab

Copy link
Copy Markdown
Member

/azp run

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
Successfully started running 2 pipeline(s).

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🟡 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
@a0x1ab

Copy link
Copy Markdown
Member

/azp run

@azure-pipelines

Copy link
Copy Markdown
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
@a0x1ab

Copy link
Copy Markdown
Member

/azp run

@azure-pipelines

Copy link
Copy Markdown
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
@a0x1ab

Copy link
Copy Markdown
Member

/azp run

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
Successfully started running 2 pipeline(s).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Thanks. The implementation and companion AAZ alignment look good, and the create-example issue is fixed. Before approving this new extension:

  1. 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, provide live_only scenarios with passing live results and retain offline request/polling tests.
  2. Naming (you asked for input): these are suggestions:
    • az artemis doesn't match the extension name koreai-artemis, and "artemis" alone is generic at the top level; consider a brand-qualified group such as az koreai artemis.
    • Consider noun-verb instead of a root-level verb, e.g. az artemis saas activate instead of activate-saas.
    • organization list-workspaces vs organization workspace list, and workspace show-details vs workspace show, look similar. Please clarify the difference in help text or consolidate.
  3. 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
@a0x1ab

Copy link
Copy Markdown
Member

/azp run

@azure-pipelines

Copy link
Copy Markdown
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
@a0x1ab

Copy link
Copy Markdown
Member

/azp run

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
Successfully started running 2 pipeline(s).

@yonzhan

Copy link
Copy Markdown
Collaborator

Please fix CI issues

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 03025721-bce8-4b17-af2c-e7f7a413bacf
@a0x1ab

Copy link
Copy Markdown
Member

/azp run

@azure-pipelines

Copy link
Copy Markdown
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
@a0x1ab

Copy link
Copy Markdown
Member

/azp run

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
Successfully started running 2 pipeline(s).

@naga-nandyala

Naga Nandyala (naga-nandyala) commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

Shiwani (@shiwanijain)

Thanks for the thorough update. The az koreai artemis layout, scoped linter exclusions, and offline tests (including update-preserves-configuration and SaaS --no-wait) address the earlier feedback; Two small cleanups before merge: remove the now-stale artemis: entry from the root linter_exclusions.yml, and update README examples from az artemis to az koreai artemis. Will merge together with Azure/aaz#1154.

@naga-nandyala

Copy link
Copy Markdown
Contributor

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
@a0x1ab

Copy link
Copy Markdown
Member

/azp run

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
Successfully started running 2 pipeline(s).

@yonzhan
Yong Zhang (yonzhan) requested a review from a team November 16, 2026 05:55
@naga-nandyala
Naga Nandyala (naga-nandyala) merged commit 704dbeb into Azure:main Nov 16, 2026
24 checks passed
@azclibot

Copy link
Copy Markdown
Collaborator

[Release] Update index.json for extension [ koreai-artemis-1.0.0b1 ] : https://dev.azure.com/msazure/One/_build/results?buildId=191428683&view=results

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

9 participants