cognitiveservices agent status: add --only-show-status

Author: GitHub Copilot

src/azure-cli/azure/cli/command_modules/cognitiveservices/_help.py

@@ -664,9 +664,14 @@
 short-summary: Get the status of a hosted agent deployment.
 long-summary: |
     Calls the agent container status endpoint and returns the raw service payload.
+parameters:
+  - name: --only-show-status
+    short-summary: Only return the status field.
 examples:
   - name: Get hosted agent deployment status.
     text: az cognitiveservices agent status --account-name myAccount --project-name myProject --name myAgent --agent-version 1
+  - name: Get only the status field.
+    text: az cognitiveservices agent status --account-name myAccount --project-name myProject --name myAgent --agent-version 1 --only-show-status
 """
 
 helps[

src/azure-cli/azure/cli/command_modules/cognitiveservices/_params.py

@@ -393,6 +393,12 @@ def load_arguments(self, _):
             help="Cognitive Services hosted agent version",
             required=True,
         )
+        c.argument(
+            "only_show_status",
+            options_list=["--only-show-status"],
+            action="store_true",
+            help="Only return the deployment status field.",
+        )
 
     with self.argument_context('cognitiveservices agent create') as c:
         c.argument(

src/azure-cli/azure/cli/command_modules/cognitiveservices/custom.py

@@ -1399,9 +1399,13 @@ def agent_status(
     project_name,
     agent_name,
     agent_version,
+    only_show_status=False,
 ):  # pylint: disable=unused-argument
     """Get the status of a hosted agent deployment (default container)."""
-    return _get_agent_container_status(client, agent_name, agent_version)
+    payload = _get_agent_container_status(client, agent_name, agent_version)
+    if only_show_status:
+        return {"status": payload.get("status")}
+    return payload
 
 
 def _get_resource_group_by_account_name(cmd, account_name):