|
324 | 324 | "query" |
325 | 325 | ], |
326 | 326 | "summary": "Query Endpoint Handler", |
327 | | - "description": "Handle request to the /query endpoint.\n\nProcesses a POST request to the /query endpoint, forwarding the\nuser's query to a selected Llama Stack LLM or agent and\nreturning the generated response.\n\nValidates configuration and authentication, selects the appropriate model\nand provider, retrieves the LLM response, updates metrics, and optionally\nstores a transcript of the interaction. Handles connection errors to the\nLlama Stack service by returning an HTTP 500 error.\n\nReturns:\n QueryResponse: Contains the conversation ID and the LLM-generated response.", |
| 327 | + "description": "Handle request to the /query endpoint using Agent API.\n\nThis is a wrapper around query_endpoint_handler_base that provides\nthe Agent API specific retrieve_response and get_topic_summary functions.\n\nReturns:\n QueryResponse: Contains the conversation ID and the LLM-generated response.", |
328 | 328 | "operationId": "query_endpoint_handler_v1_query_post", |
329 | 329 | "requestBody": { |
330 | 330 | "content": { |
|
355 | 355 | } |
356 | 356 | ] |
357 | 357 | }, |
358 | | - "400": { |
| 358 | + "401": { |
359 | 359 | "description": "Missing or invalid credentials provided by client", |
360 | 360 | "content": { |
361 | 361 | "application/json": { |
|
375 | 375 | } |
376 | 376 | } |
377 | 377 | }, |
| 378 | + "404": { |
| 379 | + "description": "Requested model or provider not found" |
| 380 | + }, |
378 | 381 | "500": { |
379 | 382 | "description": "Internal Server Error", |
380 | 383 | "detail": { |
|
631 | 634 | "operationId": "feedback_status_v1_feedback_status_get", |
632 | 635 | "responses": { |
633 | 636 | "200": { |
634 | | - "description": "Successful Response", |
| 637 | + "description": "Feedback status successfully retrieved", |
635 | 638 | "content": { |
636 | 639 | "application/json": { |
637 | 640 | "schema": { |
|
661 | 664 | }, |
662 | 665 | "responses": { |
663 | 666 | "200": { |
664 | | - "description": "Successful Response", |
| 667 | + "description": "Feedback status successfully updated", |
665 | 668 | "content": { |
666 | 669 | "application/json": { |
667 | 670 | "schema": { |
|
670 | 673 | } |
671 | 674 | } |
672 | 675 | }, |
| 676 | + "400": { |
| 677 | + "description": "Missing or invalid credentials provided by client", |
| 678 | + "content": { |
| 679 | + "application/json": { |
| 680 | + "schema": { |
| 681 | + "$ref": "#/components/schemas/UnauthorizedResponse" |
| 682 | + } |
| 683 | + } |
| 684 | + } |
| 685 | + }, |
| 686 | + "401": { |
| 687 | + "description": "Missing or invalid credentials provided by client", |
| 688 | + "content": { |
| 689 | + "application/json": { |
| 690 | + "schema": { |
| 691 | + "$ref": "#/components/schemas/UnauthorizedResponse" |
| 692 | + } |
| 693 | + } |
| 694 | + } |
| 695 | + }, |
| 696 | + "403": { |
| 697 | + "description": "Client does not have permission to access resource", |
| 698 | + "content": { |
| 699 | + "application/json": { |
| 700 | + "schema": { |
| 701 | + "$ref": "#/components/schemas/ForbiddenResponse" |
| 702 | + } |
| 703 | + } |
| 704 | + } |
| 705 | + }, |
673 | 706 | "422": { |
674 | 707 | "description": "Validation Error", |
675 | 708 | "content": { |
|
1179 | 1212 | } |
1180 | 1213 | } |
1181 | 1214 | }, |
| 1215 | + "/v2/query": { |
| 1216 | + "post": { |
| 1217 | + "tags": [ |
| 1218 | + "query_v2" |
| 1219 | + ], |
| 1220 | + "summary": "Query Endpoint Handler V2", |
| 1221 | + "description": "Handle request to the /query endpoint using Responses API.\n\nThis is a wrapper around query_endpoint_handler_base that provides\nthe Responses API specific retrieve_response and get_topic_summary functions.\n\nReturns:\n QueryResponse: Contains the conversation ID and the LLM-generated response.", |
| 1222 | + "operationId": "query_endpoint_handler_v2_v2_query_post", |
| 1223 | + "requestBody": { |
| 1224 | + "content": { |
| 1225 | + "application/json": { |
| 1226 | + "schema": { |
| 1227 | + "$ref": "#/components/schemas/QueryRequest" |
| 1228 | + } |
| 1229 | + } |
| 1230 | + }, |
| 1231 | + "required": true |
| 1232 | + }, |
| 1233 | + "responses": { |
| 1234 | + "200": { |
| 1235 | + "description": "Successful Response", |
| 1236 | + "content": { |
| 1237 | + "application/json": { |
| 1238 | + "schema": { |
| 1239 | + "$ref": "#/components/schemas/QueryResponse" |
| 1240 | + } |
| 1241 | + } |
| 1242 | + }, |
| 1243 | + "conversation_id": "123e4567-e89b-12d3-a456-426614174000", |
| 1244 | + "response": "LLM answer", |
| 1245 | + "referenced_documents": [ |
| 1246 | + { |
| 1247 | + "doc_url": "https://docs.openshift.com/container-platform/4.15/operators/olm/index.html", |
| 1248 | + "doc_title": "Operator Lifecycle Manager (OLM)" |
| 1249 | + } |
| 1250 | + ] |
| 1251 | + }, |
| 1252 | + "400": { |
| 1253 | + "description": "Missing or invalid credentials provided by client", |
| 1254 | + "content": { |
| 1255 | + "application/json": { |
| 1256 | + "schema": { |
| 1257 | + "$ref": "#/components/schemas/UnauthorizedResponse" |
| 1258 | + } |
| 1259 | + } |
| 1260 | + } |
| 1261 | + }, |
| 1262 | + "403": { |
| 1263 | + "description": "User is not authorized", |
| 1264 | + "content": { |
| 1265 | + "application/json": { |
| 1266 | + "schema": { |
| 1267 | + "$ref": "#/components/schemas/ForbiddenResponse" |
| 1268 | + } |
| 1269 | + } |
| 1270 | + } |
| 1271 | + }, |
| 1272 | + "500": { |
| 1273 | + "description": "Internal Server Error", |
| 1274 | + "detail": { |
| 1275 | + "response": "Unable to connect to Llama Stack", |
| 1276 | + "cause": "Connection error." |
| 1277 | + } |
| 1278 | + }, |
| 1279 | + "422": { |
| 1280 | + "description": "Validation Error", |
| 1281 | + "content": { |
| 1282 | + "application/json": { |
| 1283 | + "schema": { |
| 1284 | + "$ref": "#/components/schemas/HTTPValidationError" |
| 1285 | + } |
| 1286 | + } |
| 1287 | + } |
| 1288 | + } |
| 1289 | + } |
| 1290 | + } |
| 1291 | + }, |
1182 | 1292 | "/readiness": { |
1183 | 1293 | "get": { |
1184 | 1294 | "tags": [ |
|
1436 | 1546 | } |
1437 | 1547 | ] |
1438 | 1548 | }, |
1439 | | - "AuthenticationConfiguration-Input": { |
| 1549 | + "AuthenticationConfiguration": { |
1440 | 1550 | "properties": { |
1441 | 1551 | "module": { |
1442 | 1552 | "type": "string", |
|
1476 | 1586 | "jwk_config": { |
1477 | 1587 | "anyOf": [ |
1478 | 1588 | { |
1479 | | - "$ref": "#/components/schemas/JwkConfiguration-Input" |
| 1589 | + "$ref": "#/components/schemas/JwkConfiguration" |
1480 | 1590 | }, |
1481 | 1591 | { |
1482 | 1592 | "type": "null" |
|
1489 | 1599 | "title": "AuthenticationConfiguration", |
1490 | 1600 | "description": "Authentication configuration." |
1491 | 1601 | }, |
1492 | | - "AuthenticationConfiguration-Output": { |
1493 | | - "properties": { |
1494 | | - "module": { |
1495 | | - "type": "string", |
1496 | | - "title": "Module", |
1497 | | - "default": "noop" |
1498 | | - }, |
1499 | | - "skip_tls_verification": { |
1500 | | - "type": "boolean", |
1501 | | - "title": "Skip Tls Verification", |
1502 | | - "default": false |
1503 | | - }, |
1504 | | - "k8s_cluster_api": { |
1505 | | - "anyOf": [ |
1506 | | - { |
1507 | | - "type": "string", |
1508 | | - "minLength": 1, |
1509 | | - "format": "uri" |
1510 | | - }, |
1511 | | - { |
1512 | | - "type": "null" |
1513 | | - } |
1514 | | - ], |
1515 | | - "title": "K8S Cluster Api" |
1516 | | - }, |
1517 | | - "k8s_ca_cert_path": { |
1518 | | - "anyOf": [ |
1519 | | - { |
1520 | | - "type": "string", |
1521 | | - "format": "file-path" |
1522 | | - }, |
1523 | | - { |
1524 | | - "type": "null" |
1525 | | - } |
1526 | | - ], |
1527 | | - "title": "K8S Ca Cert Path" |
1528 | | - }, |
1529 | | - "jwk_config": { |
1530 | | - "anyOf": [ |
1531 | | - { |
1532 | | - "$ref": "#/components/schemas/JwkConfiguration-Output" |
1533 | | - }, |
1534 | | - { |
1535 | | - "type": "null" |
1536 | | - } |
1537 | | - ] |
1538 | | - } |
1539 | | - }, |
1540 | | - "additionalProperties": false, |
1541 | | - "type": "object", |
1542 | | - "title": "AuthenticationConfiguration", |
1543 | | - "description": "Authentication configuration." |
1544 | | - }, |
1545 | | - "AuthorizationConfiguration-Input": { |
1546 | | - "properties": { |
1547 | | - "access_rules": { |
1548 | | - "items": { |
1549 | | - "$ref": "#/components/schemas/AccessRule" |
1550 | | - }, |
1551 | | - "type": "array", |
1552 | | - "title": "Access Rules" |
1553 | | - } |
1554 | | - }, |
1555 | | - "additionalProperties": false, |
1556 | | - "type": "object", |
1557 | | - "title": "AuthorizationConfiguration", |
1558 | | - "description": "Authorization configuration." |
1559 | | - }, |
1560 | | - "AuthorizationConfiguration-Output": { |
| 1602 | + "AuthorizationConfiguration": { |
1561 | 1603 | "properties": { |
1562 | 1604 | "access_rules": { |
1563 | 1605 | "items": { |
|
1753 | 1795 | "title": "Mcp Servers" |
1754 | 1796 | }, |
1755 | 1797 | "authentication": { |
1756 | | - "$ref": "#/components/schemas/AuthenticationConfiguration-Output" |
| 1798 | + "$ref": "#/components/schemas/AuthenticationConfiguration" |
1757 | 1799 | }, |
1758 | 1800 | "authorization": { |
1759 | 1801 | "anyOf": [ |
1760 | 1802 | { |
1761 | | - "$ref": "#/components/schemas/AuthorizationConfiguration-Output" |
| 1803 | + "$ref": "#/components/schemas/AuthorizationConfiguration" |
1762 | 1804 | }, |
1763 | 1805 | { |
1764 | 1806 | "type": "null" |
|
2717 | 2759 | "title": "JsonPathOperator", |
2718 | 2760 | "description": "Supported operators for JSONPath evaluation." |
2719 | 2761 | }, |
2720 | | - "JwkConfiguration-Input": { |
| 2762 | + "JwkConfiguration": { |
2721 | 2763 | "properties": { |
2722 | 2764 | "url": { |
2723 | 2765 | "type": "string", |
|
2726 | 2768 | "title": "Url" |
2727 | 2769 | }, |
2728 | 2770 | "jwt_configuration": { |
2729 | | - "$ref": "#/components/schemas/JwtConfiguration-Input" |
| 2771 | + "$ref": "#/components/schemas/JwtConfiguration" |
2730 | 2772 | } |
2731 | 2773 | }, |
2732 | 2774 | "additionalProperties": false, |
|
2737 | 2779 | "title": "JwkConfiguration", |
2738 | 2780 | "description": "JWK configuration." |
2739 | 2781 | }, |
2740 | | - "JwkConfiguration-Output": { |
2741 | | - "properties": { |
2742 | | - "url": { |
2743 | | - "type": "string", |
2744 | | - "minLength": 1, |
2745 | | - "format": "uri", |
2746 | | - "title": "Url" |
2747 | | - }, |
2748 | | - "jwt_configuration": { |
2749 | | - "$ref": "#/components/schemas/JwtConfiguration-Output" |
2750 | | - } |
2751 | | - }, |
2752 | | - "additionalProperties": false, |
2753 | | - "type": "object", |
2754 | | - "required": [ |
2755 | | - "url" |
2756 | | - ], |
2757 | | - "title": "JwkConfiguration", |
2758 | | - "description": "JWK configuration." |
2759 | | - }, |
2760 | | - "JwtConfiguration-Input": { |
2761 | | - "properties": { |
2762 | | - "user_id_claim": { |
2763 | | - "type": "string", |
2764 | | - "title": "User Id Claim", |
2765 | | - "default": "user_id" |
2766 | | - }, |
2767 | | - "username_claim": { |
2768 | | - "type": "string", |
2769 | | - "title": "Username Claim", |
2770 | | - "default": "username" |
2771 | | - }, |
2772 | | - "role_rules": { |
2773 | | - "items": { |
2774 | | - "$ref": "#/components/schemas/JwtRoleRule" |
2775 | | - }, |
2776 | | - "type": "array", |
2777 | | - "title": "Role Rules" |
2778 | | - } |
2779 | | - }, |
2780 | | - "additionalProperties": false, |
2781 | | - "type": "object", |
2782 | | - "title": "JwtConfiguration", |
2783 | | - "description": "JWT configuration." |
2784 | | - }, |
2785 | | - "JwtConfiguration-Output": { |
| 2782 | + "JwtConfiguration": { |
2786 | 2783 | "properties": { |
2787 | 2784 | "user_id_claim": { |
2788 | 2785 | "type": "string", |
|
0 commit comments