{"ref":"artifact:sap-samples-btp-ai-bp-access-to-generative-ai-models-cap","page":"/artifacts/sap-samples-btp-ai-bp-access-to-generative-ai-models-cap","json":"/artifacts/sap-samples-btp-ai-bp-access-to-generative-ai-models-cap.json","generated":"2026-11-15","drafted_with_ai":true,"entity":{"id":"sap-samples-btp-ai-bp-access-to-generative-ai-models-cap","name":"Sample CAP Application with SAP Cloud SDK for AI","artifact_type":"sample","ecosystem":"cap","serves_ecosystems":["btp"],"flavors":[{"key":"node","source":{"url":"https://raw.githubusercontent.com/SAP-samples/sap-btp-ai-best-practices/main/best-practices/generative-ai/access-to-generative-ai-models/cap/backend-sample/README.md","title":"SAP-samples/sap-btp-ai-best-practices — access-to-generative-ai-models/cap/backend-sample README, prerequisites","checked":"2026-10-19","quote":"Node.js LTS version"}}],"use_as":"reference","domain":"ai-and-agents","origin_ring":"sap-official","description":{"one_line":"A CAP backend-sample and fullstack-sample pair that call [SAP AI Core](artifact:btp-ai-core) through the SAP Cloud SDK for AI: a capital-of-country question and a templated chat completion.","short":"CAP samples calling SAP AI Core through the SAP Cloud SDK for AI","what_it_solves":"The backend-sample is a standalone CAP service with an `orchestration` CDS service exposing two actions, `askCapitalOfCountry` and a templated `chatCompletion`, built with [@sap-ai-sdk/ai-api](artifact:sap-ai-sdk-ai-api), [@sap-ai-sdk/foundation-models](artifact:sap-ai-sdk-foundation-models) and [@sap-ai-sdk/orchestration](artifact:sap-ai-sdk-orchestration); the fullstack-sample pairs the same service with a UI5 app under app/ask-capital that calls it over OData V4. For a local run both bind to an [SAP AI Core](artifact:btp-ai-core) instance with `cds bind`; the deployed fullstack sample names the instance in its mta.yml instead.","when_not_to_use":"Every CDS service in both samples is marked `@requires: 'any'` and left publicly accessible, which the README says simplifies the deployment process, and it asks for proper authentication mechanisms to be applied in their place."},"links":{"repo":"https://github.com/SAP-samples/sap-btp-ai-best-practices/tree/main/best-practices/generative-ai/access-to-generative-ai-models/cap"},"type_properties":{"form":{"value":"reference-application","sources":[{"url":"https://raw.githubusercontent.com/SAP-samples/sap-btp-ai-best-practices/main/best-practices/generative-ai/access-to-generative-ai-models/cap/backend-sample/README.md","title":"SAP-samples/sap-btp-ai-best-practices — access-to-generative-ai-models/cap/backend-sample README","checked":"2026-10-19","quote":"This project demonstrates best practices for accessing generative AI models through a CAP (Cloud Application Programming model) application using the SAP Cloud SDK for AI."}]}},"identity":{"license":"Apache-2.0"},"source_available":true,"compat":{"runtimes":["node"]},"demonstrates":["capability:llm-integration"],"requires":[{"ref":"artifact:btp-ai-core","for":"The service instance the samples call for both actions, bound locally with `cds bind` or named in the fullstack sample's mta.yml.","sources":[{"url":"https://raw.githubusercontent.com/SAP-samples/sap-btp-ai-best-practices/main/best-practices/generative-ai/access-to-generative-ai-models/cap/backend-sample/README.md","title":"SAP-samples/sap-btp-ai-best-practices — access-to-generative-ai-models/cap/backend-sample README","checked":"2026-10-19","quote":"Access to SAP AI Core service"}]}],"connects":[{"ref":"artifact:btp-ai-core","kind":"data","direction":"outbound","for":"The prompt each action sends to a language model and the response it returns to the caller.","sources":[{"url":"https://raw.githubusercontent.com/SAP-samples/sap-btp-ai-best-practices/main/best-practices/generative-ai/access-to-generative-ai-models/cap/backend-sample/README.md","title":"SAP-samples/sap-btp-ai-best-practices — access-to-generative-ai-models/cap/backend-sample README, configuration","checked":"2026-10-19","quote":"The application requires proper configuration to connect to the SAP AI Core service. This is handled through CDS bindings in both local and remote deployments."},{"url":"https://raw.githubusercontent.com/SAP-samples/sap-btp-ai-best-practices/main/best-practices/generative-ai/access-to-generative-ai-models/cap/backend-sample/README.md","title":"SAP-samples/sap-btp-ai-best-practices — access-to-generative-ai-models/cap/backend-sample README","checked":"2026-10-19","quote":"It provides examples of how to interact with language models to obtain responses based on user prompts within a CAP service context."}]}],"interfaces":[{"kind":"api","protocol":"odata-v4","direction":"in","for":"The two `orchestration` actions a caller posts to, `askCapitalOfCountry` and `chatCompletion`.","sources":[{"url":"https://raw.githubusercontent.com/SAP-samples/sap-btp-ai-best-practices/main/best-practices/generative-ai/access-to-generative-ai-models/cap/fullstack-sample/README.md","title":"SAP-samples/sap-btp-ai-best-practices — access-to-generative-ai-models/cap/fullstack-sample README, usage","checked":"2026-10-19","quote":"Backend Services (OData v4)"},{"url":"https://raw.githubusercontent.com/SAP-samples/sap-btp-ai-best-practices/main/best-practices/generative-ai/access-to-generative-ai-models/cap/backend-sample/README.md","title":"SAP-samples/sap-btp-ai-best-practices — access-to-generative-ai-models/cap/backend-sample README, usage","checked":"2026-10-19","quote":"--url $SAMPLE_CAP_HOST/odata/v4/orchestration/askCapitalOfCountry"}]}],"maintainers":["actor:sap-samples"],"drafted_with_ai":true,"provenance":{"discovered_via":[{"source":"source:curator"}],"first_seen":"2026-09-14"},"contributors":["actor:luismarques-io"]},"effective_normative_relations":[],"readings":{"liveness":[{"label":"Maintenance","tier":"unknown","evidence":"no release data"},{"label":"Continuity","tier":"good","evidence":"15 contributors, org-owned"},{"label":"Repository","tier":"good","evidence":"pushed 2026-11, not archived"}],"compatibility":[{"label":"Declared for","tier":"fair","evidence":"nothing declared"},{"label":"Survived majors","tier":"unknown","evidence":"no release dates"},{"label":"Maintainer's CI","tier":"fair","evidence":"no CI configured"}],"practice":[{"label":"Tests","tier":"good","evidence":"315 test files"},{"label":"Docs","tier":"poor","evidence":"README 1 KB"},{"label":"Changelog","tier":"fair","evidence":"none in the repo"}],"reach":[{"value":null,"unit":"installs/week"},{"value":73,"unit":"watching"}]},"signals":{"crawled_at":"2026-11-13","npm":"not published under this name","stars":73,"forks":61,"open_issues":13,"archived":false,"pushed_at":"2026-11-11","license_spdx":"Apache-2.0","org_owned":true,"default_branch":"main","created_at":"2025-03-07T14:29:58Z","open_prs":6,"tree_truncated":false,"test_files":315,"workflows":0,"other_ci":false,"readme_bytes":789,"docs_files":0,"changelog":false,"license_file":true,"dts_files":2,"first_commit":"2025-05-27","last_commit":"2025-05-27","commits":1,"contributors":15,"readme_path":"best-practices/generative-ai/access-to-generative-ai-models/cap/README.md","readme_sha":"ad35c20aad9601600b321c7a38d76a390515191f","repo_read":"2026-11-13","language":"Jupyter Notebook"},"edges":{"maintainers":[{"ref":"actor:sap-samples","name":"SAP Samples","json":"/actors/sap-samples.json"}],"contributors":[{"ref":"actor:luismarques-io","name":"Luís Marques","json":"/actors/luismarques-io.json"}],"explained_by":[],"alternative_to_this":[],"needed_by":[],"available_via":[],"parts":[],"add_ons":[],"answered_through_parts":[]}}