How sap-samples/btp-cap-genai-semantic-search works
This is a SAP BTP CAP semantic-search sample. A user submits a query in the SAPUI5 interface; the request is routed to the CAP search service, which may reformulate the text, derive metadata filters, generate an embedding, and query HANA for similar documents. The service also supports embedding and storing documents. The README documents Generative AI Hub and HANA Vector Engine; backend behavior is based on the sampled service excerpt, while routing and service definitions are represented only where the tree supports exact paths.
Main entry points: sample.ts Sample service · xs-app.json Application router · sample.cds CAP service endpoint · Main.controller.ts Search controller
Components 13
Search interface
- Search controller
ui/webapp/controller/Main.controller.ts - Search view
ui/webapp/view/Main.view.xml
Request routing
- Application router
router/xs-app.json
Search service
- CAP service endpoint
api/srv/sample.cds - Sample service
api/srv/sample.ts - Query reformulation
api/srv/sample.ts - Metadata filtering
api/srv/sample.ts - Embedding generation
api/srv/sample.ts - Document ingestion
api/srv/sample.ts
AI and persistence
- LLM orchestration
- Embedding provider
- HANA document store
api/db/schema.cds
Other components
- Search user
Connections 19
- Search user → Search view: enters query
- Search view → Search controller: triggers search
- Search controller → Application router: POSTs search
- Application router → CAP service endpoint: forwards request
- CAP service endpoint → Sample service: dispatches search
- Sample service → Query reformulation: reformulates text
- Query reformulation → LLM orchestration: requests completion
- Sample service → Metadata filtering: extracts filters
- Metadata filtering → LLM orchestration: requests completion
- Sample service → Embedding generation: embeds query
- Embedding generation → Embedding provider: requests vector
- Sample service → HANA document store: runs similarity query
- HANA document store → Sample service: returns matches
- Sample service → CAP service endpoint: returns documents
- CAP service endpoint → Application router: returns response
- Application router → Search controller: delivers results
- Sample service → Document ingestion: dispatches embedding
- Document ingestion → Embedding provider: requests vector
- Document ingestion → HANA document store: stores document vector