Update orchestration based on main

Author: bot-sdk-js

orchestration/src/main/resources/spec/orchestration.yaml

@@ -1,5 +1,7 @@
 openapi: 3.0.0
 
+x-sap-shortText: "Orchestration provides common capabilities for business AI scenarios, such as content filtering, data masking, and grounding"
+
 info:
   title: Internal Orchestration Service API
   description: Orchestration is an inference service which provides common additional capabilities for business AI scenarios, such as content filtering and data masking. At the core of the service is the LLM module which allows for an easy, harmonized access to the language models of gen AI hub. The service is designed to be modular and extensible, allowing for the addition of new modules in the future. Each module can be configured independently and at runtime, allowing for a high degree of flexibility in the orchestration of AI services.
@@ -19,6 +21,7 @@ paths:
     post:
       tags:
         - OrchestrationCompletion
+      summary: orchestrated completion inference
       description: Run an orchestrated completion inference request
       operationId: orchestration.v1.endpoints.create
       requestBody:
@@ -1319,3 +1322,11 @@ components:
         application/json:
           schema:
             $ref: "#/components/schemas/ErrorResponse"
+
+  # https://pages.github.tools.sap/CPA/api-metadata-validator/rules/oas/sap-oas3-security/
+  securitySchemes:
+    bearerAuth:
+      type: http
+      scheme: bearer
+      bearerFormat: JWT
+      description: To use this API, you must have an AI Core access token.