Skip to content

feat(workshops): add enterprise-data-agent harness workshop + notebook#137

Merged
jasperan merged 2 commits into
oracle-devrel:mainfrom
jasperan:feat/enterprise-data-agent-workshop
May 12, 2026
Merged

feat(workshops): add enterprise-data-agent harness workshop + notebook#137
jasperan merged 2 commits into
oracle-devrel:mainfrom
jasperan:feat/enterprise-data-agent-workshop

Conversation

@jasperan
Copy link
Copy Markdown
Member

Summary

  • Adds workshops/enterprise-data-agent-harness-workshop/ — a full end-to-end workshop showing the agent-harness pattern on Oracle AI Database 26ai: FastAPI backend, OAMP-backed memory, in-DB ONNX embedder, reranker, scheduler, DBFS, MLE, JSON Duality Views, plus a React/Vite frontend and a devcontainer scaffold for one-click setup in Codespaces.
  • Adds notebooks/enterprise_data_agent.ipynb — companion notebook walking through the same harness step by step.
  • Removes scripts/cyp-runs/ — workshop-specific seed/prefetch fixtures that no longer belong under scripts/ (not referenced by the new workshop or any other code path).

Notes for reviewers

  • The workshop is self-contained under its own directory with its own requirements.txt, devcontainer, frontend, and docs (docs/part-1-setup.md through docs/part-11-tool-output-offload.md).
  • DB credentials in scripts/docs (OraclePwd_2025, AgentPwd_2025, SupplyPwd_2025) are intentional workshop defaults wired into docker-compose.yml, the password-reset step, and student instructions. They are not production secrets.
  • app/.env.example ships with OCI_GENAI_API_KEY=YOUR_OCI_GENAI_API_KEY as a placeholder; students fill in their own key.

Test plan

  • Open the devcontainer in Codespaces and confirm the Oracle 26ai container comes up healthy.
  • Run app/scripts/bootstrap.py and verify the ONNX embedder registers in-DB.
  • Step through enterprise_data_agent.ipynb end-to-end.
  • Run the FastAPI backend + Vite frontend and confirm the agent loop returns tool calls.
  • Confirm scripts/cyp-runs/ is gone after merge and nothing else references it (grep clean).

jasperan added 2 commits May 12, 2026 15:45
New end-to-end workshop demonstrating the agent harness pattern on Oracle
AI Database 26ai (FastAPI backend, OAMP-backed memory, in-DB ONNX
embedder, devcontainer scaffold) plus the companion notebook under
notebooks/.
These prefetch / seed-PDF / runbook fixtures were workshop-specific
scaffolding that no longer belongs in scripts/.
@oracle-contributor-agreement oracle-contributor-agreement Bot added the OCA Verified All contributors have signed the Oracle Contributor Agreement. label May 12, 2026
@jasperan jasperan requested a review from casius-connect May 12, 2026 15:52
@jasperan jasperan self-assigned this May 12, 2026
Copy link
Copy Markdown
Collaborator

@casius-connect casius-connect left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

happy

@jasperan jasperan merged commit 7f9021a into oracle-devrel:main May 12, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

OCA Verified All contributors have signed the Oracle Contributor Agreement.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants