OpenEvidence Supported Interaction Patterns
Overview
Convert an SDK-shaped request into a documented product workflow or a vendor-confirmation question. Keep inputs minimal, separate observed facts from assumptions, and leave consequential decisions with the named accountable owner.
Prerequisites
- A clearly bounded workflow, accountable clinical owner, and organizational policy
- Current first-party OpenEvidence documentation and applicable institution agreements
- Synthetic or properly authorized minimum-necessary data
Tool Discipline
Use Read, Glob, and Grep to inspect supplied policies, plans, and evidence. Use WebFetch only for current first-party OpenEvidence documentation. Use Write or Edit only when the user requests a named deliverable with an approved destination. Never expose credentials, PHI, recordings, or unrestricted environment output.
Current Contract
- The audited first-party materials do not publish an OpenEvidence SDK or developer API.
- Similarly named npm and PyPI packages are not an authenticated OpenEvidence integration path.
- Supported patterns include end-user Ask and documented feature workflows, subject to current guide and account availability.
Authentication
Use only the official OpenEvidence web/mobile sign-in or an institution-approved access path. Do not invent API keys, OAuth clients, SDK credentials, service accounts, or private endpoints. Never ask a user to reveal a password, session token, cookie, or recovery code.
Instructions
- Identify the desired outcome and why the requester thinks code integration is required.
- Search current first-party documentation for an explicit developer contract, package, authentication method, and terms.
- If absent, reject package installation, private-endpoint probing, browser automation, and credential extraction.
- Map the outcome to a supported product pattern: focused Ask, Snow literature investigation, Collections, Dotflows, Visits, or approved manual handoff.
- If automation remains necessary, write precise vendor questions covering API, auth, scope, PHI, limits, SLA, and support.
- Return the supported pattern, rejected assumptions, evidence date, and approval owner.
Approval Boundaries
Do not create or share accounts; change access, roles, agreements, consent, retention, or security settings; enter PHI; record a conversation; copy content into another system; contact a patient; make a diagnosis or treatment decision; submit billing; transmit a support packet; run a production pilot; or represent vendor capabilities without explicit approval from the accountable owner. A qualified professional remains responsible for clinical decisions.
Output
Return scope, current first-party evidence and date, data classification, workflow or findings, citations reviewed, assumptions rejected, clinical and governance owners, approval state, unresolved risk, and the exact next action. Redact patient and credential data.
Error Handling
| Condition | Response |
|---|---|
| Third-party package found | Do not trust namespace alone; require first-party documentation and provenance. |
| Requester needs bulk automation | Escalate to vendor/contract owner; do not scrape or reverse-engineer. |
| Manual workflow unacceptable | Record the product gap and stop. |
Examples
This compact example shows the minimum reviewable handoff; adapt fields to the approved workflow without adding sensitive data.
Input:
request=embed evidence search in app; package=@openevidence/sdk
Expected handoff:
sdk=unsupported; install=blocked; documented-alternative=manual Ask; vendor-questions=7