{"ref":"artifact:mi8y-cap-agents-sdm-reports-assistant","page":"/artifacts/mi8y-cap-agents-sdm-reports-assistant","json":"/artifacts/mi8y-cap-agents-sdm-reports-assistant.json","generated":"2026-10-26","drafted_with_ai":true,"entity":{"id":"mi8y-cap-agents-sdm-reports-assistant","name":"Reports Assistant with SAP Document Management","artifact_type":"sample","ecosystem":"cap","domain":"ai-and-agents","origin_ring":"independent","use_as":"starting-point","source_available":true,"description":{"one_line":"A CAP agent that turns a few notes into a status report and saves it in an SAP Document Management repository, where the instructions and the skills it follows are kept too.","short":"CAP agent writing reports into a shared SDM document workspace","what_it_solves":"The worked example in the repository behind [@mi8y/cap-agents-sdm-backend](artifact:mi8y-cap-agents-sdm-backend): a CAP agent built with [@cap-js/agents](artifact:cap-js-agents) and [Deep Agents](external:deepagents) that copies a controlled template, fills it from the notes a user supplies, and saves a `.txt` report people can open in the embedded Document Management UI beside the chat. A `buildGraph` override mounts the backend, with `/report/` and `/skills/` mapped to folders of the same name in the repository; `pnpm setup:sdm` creates them and uploads the local `seed/` content, whose `AGENTS.md` lands as the guidance at the repository root and whose three `SKILL.md` files become the skills the agent discovers. Because that content lives in the repository rather than in the project, editing the copies in [SAP Document Management](artifact:btp-document-management-integration) and starting a new chat changes what the agent follows, and the local `seed/` directory is starter content rather than a runtime fallback. The README names what has to be bound: a Cloud Foundry space with AI Core, Document Management, Destination, XSUAA and HTML5 Application Repository, with the model set through `cds.requires.llm.destinationName`. It also separates the two identities in play, since setup uses the SDM service key's client credentials while agent requests use the signed-in user's JWT.","to_build_on_it":"The seeded `AGENTS.md` and the three skills under `seed/` are the part a different workspace replaces, uploaded by the same setup command, with `SKILL.md` filenames kept for discovery. What it leaves open is enforcement: the README states that template protection and the confirmation before an existing report is edited are prompt instructions, not locks or access controls, and that live cloud behaviour depends on the bindings while its own checks cover skill discovery and template file operations. The prompts it ships write `.txt` files into whichever repository is connected."},"compat":{"runtimes":["node"],"deployment":["cf"]},"part_of":{"ref":"artifact:mi8y-cap-agents-sdm-backend","sources":[{"url":"https://www.npmjs.com/package/@mi8y/cap-agents-sdm-backend","title":"@mi8y/cap-agents-sdm-backend — README, Example","checked":"2026-10-22","quote":"See the [local SDM reports agent](../../examples/cap-agents-sdm-backend/README.md) for a CAP `buildGraph` override mounting SDM at `/reports/`, an SAPUI5 document reuse UI, and a shared local credential file for CAP and the approuter."},{"url":"https://github.com/mi8y/cap-agents-addons","title":"mi8y/cap-agents-addons — README, Filesystem backend (SAP Document Management Service)","checked":"2026-10-22","quote":"- **Example**: [Local SDM reports agent with reuse UI](./examples/cap-agents-sdm-backend/README.md)"}]},"requires":[{"ref":"artifact:mi8y-cap-agents-sdm-backend","requirement":"required","basis":"binding","role":"filesystem-backend","for":"The filesystem the agent reads and writes: it is what mounts the SDM repository, with `/report/` and `/skills/` mapped to folders of the same name.","sources":[{"url":"https://raw.githubusercontent.com/mi8y/cap-agents-addons/main/examples/cap-agents-sdm-backend/README.md","title":"Reports Assistant with SAP Document Management — README, opening line","checked":"2026-10-22","quote":"A CAP agent that turns notes into business reports in a shared SAP Document\nManagement workspace. Built with `@cap-js/agents`, Deep Agents, and\n[`@mi8y/cap-agents-sdm-backend`](../../packages/cap-agents-sdm-backend/README.md)."},{"url":"https://raw.githubusercontent.com/mi8y/cap-agents-addons/main/examples/cap-agents-sdm-backend/README.md","title":"Reports Assistant with SAP Document Management — README, Customize","checked":"2026-10-22","quote":"- `/report/` maps to SDM `/report`; `/skills/` maps to SDM `/skills`."}]},{"ref":"artifact:cap-js-agents","requirement":"required","basis":"binding","role":"agent-framework","for":"The framework the agent itself is built in, served from the CAP application the example deploys.","sources":[{"url":"https://raw.githubusercontent.com/mi8y/cap-agents-addons/main/examples/cap-agents-sdm-backend/README.md","title":"Reports Assistant with SAP Document Management — README, opening line","checked":"2026-10-22","quote":"A CAP agent that turns notes into business reports in a shared SAP Document\nManagement workspace. Built with `@cap-js/agents`, Deep Agents, and\n[`@mi8y/cap-agents-sdm-backend`](../../packages/cap-agents-sdm-backend/README.md)."}]},{"ref":"external:deepagents","requirement":"required","basis":"binding","role":"agent-harness","for":"The harness whose filesystem backend protocol the mounted repository is reached through.","sources":[{"url":"https://raw.githubusercontent.com/mi8y/cap-agents-addons/main/examples/cap-agents-sdm-backend/README.md","title":"Reports Assistant with SAP Document Management — README, opening line","checked":"2026-10-22","quote":"A CAP agent that turns notes into business reports in a shared SAP Document\nManagement workspace. Built with `@cap-js/agents`, Deep Agents, and\n[`@mi8y/cap-agents-sdm-backend`](../../packages/cap-agents-sdm-backend/README.md)."}]},{"ref":"artifact:btp-document-management-integration","requirement":"required","basis":"binding","role":"document-repository","for":"The shared workspace: an onboarded internal repository whose ID is set in the project, holding the reports the agent writes, and the reuse UI component the application embeds to show them.","sources":[{"url":"https://raw.githubusercontent.com/mi8y/cap-agents-addons/main/examples/cap-agents-sdm-backend/README.md","title":"Reports Assistant with SAP Document Management — README, Setup","checked":"2026-10-22","quote":"Requires a SAP BTP Cloud Foundry environment with AI Core, Document Management,\nDestination, XSUAA, and HTML5 Application Repository runtime services."},{"url":"https://raw.githubusercontent.com/mi8y/cap-agents-addons/main/examples/cap-agents-sdm-backend/README.md","title":"Reports Assistant with SAP Document Management — README, Setup","checked":"2026-10-22","quote":"then set `cds.requires.sdm.settings.repositoryId` in `package.json`."},{"url":"https://community.sap.com/t5/artificial-intelligence-blogs-posts/cap-agents-that-collaborates-with-humans-announcing-cap-agents-sdm-backend/ba-p/14509181","title":"CAP Agents that collaborates with humans - Announcing `cap-agents-sdm-backend` plugin — SAP Community","checked":"2026-10-22","quote":"I added a basic reports assistant example in the repository demonstrating this pattern in a CAP application with an embedded SAPUI5 Document Management ReuseUI and an agent chat."}]},{"ref":"artifact:btp-ai-core","requirement":"required","basis":"binding","role":"model-runtime","for":"The model the agent calls, reached through the destination named in `cds.requires.llm.destinationName`.","sources":[{"url":"https://raw.githubusercontent.com/mi8y/cap-agents-addons/main/examples/cap-agents-sdm-backend/README.md","title":"Reports Assistant with SAP Document Management — README, Setup","checked":"2026-10-22","quote":"Requires a SAP BTP Cloud Foundry environment with AI Core, Document Management,\nDestination, XSUAA, and HTML5 Application Repository runtime services."},{"url":"https://raw.githubusercontent.com/mi8y/cap-agents-addons/main/examples/cap-agents-sdm-backend/README.md","title":"Reports Assistant with SAP Document Management — README, Setup","checked":"2026-10-22","quote":"set `cds.requires.llm.destinationName` and model."}]},{"ref":"artifact:btp-destination","requirement":"required","basis":"binding","role":"destinations","for":"Named addresses for the model and the SDM API, which the project configures by destination name rather than by URL.","sources":[{"url":"https://raw.githubusercontent.com/mi8y/cap-agents-addons/main/examples/cap-agents-sdm-backend/README.md","title":"Reports Assistant with SAP Document Management — README, Setup","checked":"2026-10-22","quote":"Requires a SAP BTP Cloud Foundry environment with AI Core, Document Management,\nDestination, XSUAA, and HTML5 Application Repository runtime services."},{"url":"https://raw.githubusercontent.com/mi8y/cap-agents-addons/main/examples/cap-agents-sdm-backend/README.md","title":"Reports Assistant with SAP Document Management — README, Setup","checked":"2026-10-22","quote":"set `cds.requires.llm.destinationName` and model."}]},{"ref":"artifact:btp-authorization-and-trust-management","requirement":"required","basis":"binding","role":"authentication","for":"The sign-in in front of the application, and the user JWT the agent's requests to the repository run under while setup runs on the SDM service key's client credentials.","sources":[{"url":"https://raw.githubusercontent.com/mi8y/cap-agents-addons/main/examples/cap-agents-sdm-backend/README.md","title":"Reports Assistant with SAP Document Management — README, Setup","checked":"2026-10-22","quote":"Requires a SAP BTP Cloud Foundry environment with AI Core, Document Management,\nDestination, XSUAA, and HTML5 Application Repository runtime services."},{"url":"https://raw.githubusercontent.com/mi8y/cap-agents-addons/main/examples/cap-agents-sdm-backend/README.md","title":"Reports Assistant with SAP Document Management — README, Setup","checked":"2026-10-22","quote":"Setup uses the SDM\nservice key's client credentials; agent requests use the signed-in user's JWT."}]},{"ref":"artifact:btp-html5-application-repository","requirement":"required","basis":"binding","role":"ui-hosting","for":"Serving the reports application the user opens the document browser and the agent chat in.","sources":[{"url":"https://raw.githubusercontent.com/mi8y/cap-agents-addons/main/examples/cap-agents-sdm-backend/README.md","title":"Reports Assistant with SAP Document Management — README, Setup","checked":"2026-10-22","quote":"Requires a SAP BTP Cloud Foundry environment with AI Core, Document Management,\nDestination, XSUAA, and HTML5 Application Repository runtime services."},{"url":"https://raw.githubusercontent.com/mi8y/cap-agents-addons/main/examples/cap-agents-sdm-backend/README.md","title":"Reports Assistant with SAP Document Management — README, Setup","checked":"2026-10-22","quote":"Open [localhost:5001](http://localhost:5001), sign in, and open the reports app.\nSelect **Open agent chat**, or open [the preview](http://localhost:5001/a2a/reports-agent/preview/)."}]}],"links":{"repo":"https://github.com/mi8y/cap-agents-addons/tree/main/examples/cap-agents-sdm-backend","docs":"https://raw.githubusercontent.com/mi8y/cap-agents-addons/main/examples/cap-agents-sdm-backend/README.md"},"maintainers":["actor:anselm94","actor:mi8y"],"provenance":{"discovered_via":[{"source":"source:sap-community"}],"first_seen":"2026-10-22"},"drafted_with_ai":true,"contributors":["actor:anselm94"]},"effective_normative_relations":[],"readings":{"liveness":[{"label":"Maintenance","tier":"unknown","evidence":"no release data"},{"label":"Continuity","tier":"good","evidence":"3 contributors, org-owned"},{"label":"Repository","tier":"good","evidence":"pushed 2026-10, 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":"good","evidence":"release green, 2026-10-21"}],"practice":[{"label":"Tests","tier":"good","evidence":"24 test files"},{"label":"Docs","tier":"good","evidence":"docs/ with 1 page, docs site, README 5 KB"},{"label":"Changelog","tier":"fair","evidence":"none in the repo"}],"reach":[{"value":null,"unit":"installs/week"},{"value":2,"unit":"watching"}]},"signals":{"crawled_at":"2026-10-25","npm":"not published under this name","stars":2,"forks":0,"open_issues":2,"archived":false,"pushed_at":"2026-10-21","license_spdx":"MIT","org_owned":true,"default_branch":"main","created_at":"2026-07-08T05:15:34Z","open_prs":1,"tree_truncated":false,"test_files":24,"workflows":3,"other_ci":false,"readme_bytes":5320,"docs_files":1,"changelog":false,"license_file":true,"dts_files":0,"first_commit":"2026-10-21","last_commit":"2026-10-21","commits":1,"contributors":3,"ci_status":"success","ci_run_at":"2026-10-21","ci_workflow":"release","ci_event":"push","readme_path":"examples/cap-agents-sdm-backend/README.md","readme_sha":"e2858c5621b0747f191b91256bfe4d84c33f89b8","repo_read":"2026-10-25"},"edges":{"maintainers":[{"ref":"actor:anselm94","name":"Merbin J Anselm","json":"/actors/anselm94.json"},{"ref":"actor:mi8y","name":"Mi8Y Technologies","json":"/actors/mi8y.json"}],"contributors":[{"ref":"actor:anselm94","name":"Merbin J Anselm","json":"/actors/anselm94.json"}],"explained_by":[],"alternative_to_this":[],"needed_by":[],"available_via":[],"part_of":{"ref":"artifact:mi8y-cap-agents-sdm-backend","name":"@mi8y/cap-agents-sdm-backend","json":"/artifacts/mi8y-cap-agents-sdm-backend.json"},"parts":[],"add_ons":[],"answered_through_parts":[]}}