openapi: fix the summary of the content gen endpoints (#1733)

Properly

Author: goneri

ansible_ai_connect/ai/api/views.py

@@ -833,7 +833,7 @@ class Explanation(AACSAPIView):
             429: OpenApiResponse(description="Request was throttled"),
             503: OpenApiResponse(description="Service Unavailable"),
         },
-        summary="Inline code suggestions",
+        summary="Playbook explanation",
     )
     def post(self, request) -> Response:
         self.event.playbook_length = len(self.validated_data["content"])
@@ -890,7 +890,7 @@ class ExplanationRole(AACSAPIView):
             429: OpenApiResponse(description="Request was throttled"),
             503: OpenApiResponse(description="Service Unavailable"),
         },
-        summary="Inline code suggestions",
+        summary="Role explanation",
     )
     def post(self, request) -> Response:
         llm: ModelPipelineRoleExplanation = apps.get_app_config("ai").get_model_pipeline(
@@ -945,7 +945,7 @@ class GenerationPlaybook(AACSAPIView):
             429: OpenApiResponse(description="Request was throttled"),
             503: OpenApiResponse(description="Service Unavailable"),
         },
-        summary="Inline code suggestions",
+        summary="Playbook generation",
     )
     def post(self, request) -> Response:
         self.event.create_outline = self.validated_data["createOutline"]
@@ -1013,7 +1013,7 @@ class GenerationRole(AACSAPIView):
             200: GenerationRoleResponseSerializer,
             401: OpenApiResponse(description="Unauthorized"),
         },
-        summary="Inline code suggestions",
+        summary="Role generation",
     )
     def post(self, request) -> Response:
         self.event.create_outline = self.validated_data["createOutline"]

tools/openapi-schema/ansible-ai-connect-service.json

@@ -234,7 +234,7 @@
             "post": {
                 "operationId": "ai_explanations_create",
                 "description": "Returns a text that explains a playbook.",
-                "summary": "Inline code suggestions",
+                "summary": "Playbook explanation",
                 "tags": [
                     "ai"
                 ],
@@ -302,7 +302,7 @@
             "post": {
                 "operationId": "ai_explanations_role_create",
                 "description": "Returns a text that explains a role.",
-                "summary": "Inline code suggestions",
+                "summary": "Role explanation",
                 "tags": [
                     "ai"
                 ],
@@ -434,7 +434,7 @@
             "post": {
                 "operationId": "ai_generations_playbook_create",
                 "description": "Returns a playbook based on a text input.",
-                "summary": "Inline code suggestions",
+                "summary": "Playbook generation",
                 "tags": [
                     "ai"
                 ],
@@ -502,7 +502,7 @@
             "post": {
                 "operationId": "ai_generations_role_create",
                 "description": "Returns a role based on a text input.",
-                "summary": "Inline code suggestions",
+                "summary": "Role generation",
                 "tags": [
                     "ai"
                 ],

tools/openapi-schema/ansible-ai-connect-service.yaml

@@ -155,7 +155,7 @@ paths:
     post:
       operationId: ai_explanations_create
       description: Returns a text that explains a playbook.
-      summary: Inline code suggestions
+      summary: Playbook explanation
       tags:
       - ai
       requestBody:
@@ -196,7 +196,7 @@ paths:
     post:
       operationId: ai_explanations_role_create
       description: Returns a text that explains a role.
-      summary: Inline code suggestions
+      summary: Role explanation
       tags:
       - ai
       requestBody:
@@ -279,7 +279,7 @@ paths:
     post:
       operationId: ai_generations_playbook_create
       description: Returns a playbook based on a text input.
-      summary: Inline code suggestions
+      summary: Playbook generation
       tags:
       - ai
       requestBody:
@@ -320,7 +320,7 @@ paths:
     post:
       operationId: ai_generations_role_create
       description: Returns a role based on a text input.
-      summary: Inline code suggestions
+      summary: Role generation
       tags:
       - ai
       requestBody: