julee.api.routers.knowledge_service_queries¶
Knowledge Service Queries API router for the julee CEAP system.
This module provides the API endpoints for knowledge service queries, which define how to extract specific data using external knowledge services during the assembly process.
Routes defined at root level: - GET / - List knowledge service queries (paginated) - GET /{query_id} - Get individual query details - POST / - Create new knowledge service query
These routes are mounted at /knowledge_service_queries in the main app.
Attributes¶
Functions¶
|
Create a new knowledge service query. |
|
Get knowledge service queries by IDs or list all with pagination. |
|
Get a specific knowledge service query by ID. |
Module Contents¶
- async julee.api.routers.knowledge_service_queries.create_knowledge_service_query(request, repository=Depends(get_knowledge_service_query_repository))[source]¶
Create a new knowledge service query.
This endpoint creates a new knowledge service query configuration that defines how to extract specific data using external knowledge services during the assembly process.
- Parameters:
request (julee.api.requests.CreateKnowledgeServiceQueryRequest) – The knowledge service query creation request
repository (julee.domain.repositories.knowledge_service_query.KnowledgeServiceQueryRepository) – Injected repository for persistence
- Returns:
- The created query with generated ID and
timestamps
- Return type:
- async julee.api.routers.knowledge_service_queries.get_knowledge_service_queries(ids=Query(None, description='Comma-separated list of query IDs for bulk retrieval', openapi_examples={'bulk_query': {'summary': 'Bulk retrieval example', 'value': 'query-123,query-456,query-789'}}), repository=Depends(get_knowledge_service_query_repository))[source]¶
Get knowledge service queries by IDs or list all with pagination.
This endpoint supports two modes: 1. Bulk retrieval: Pass comma-separated IDs to get specific queries 2. List all: Without IDs parameter, returns paginated list of all queries
Each query contains the configuration needed to extract specific data using external knowledge services.
- Parameters:
ids (str | None) – Optional comma-separated list of query IDs for bulk retrieval
- Returns:
- List of queries (bulk) or paginated
list (all)
- Return type:
Page[KnowledgeServiceQuery]
- async julee.api.routers.knowledge_service_queries.get_knowledge_service_query(query_id, repository=Depends(get_knowledge_service_query_repository))[source]¶
Get a specific knowledge service query by ID.
- Parameters:
query_id (str) – The ID of the query to retrieve
repository (julee.domain.repositories.knowledge_service_query.KnowledgeServiceQueryRepository) – Injected repository for data access
- Returns:
The requested query
- Return type:
- Raises:
HTTPException – 404 if query not found, 500 for internal errors