Health Universe
  • Core Concepts
    • Overview of Health Universe
    • How Health Universe Works
  • Building Apps in Health Universe
    • Getting started with Health Universe
      • Create a Health Universe Account
      • Create a Github Account
      • Link your Github Account to your Health Universe Account
    • Creating a Workspace
    • Developing your Health Universe App
      • Streamlit vs FastAPI
      • Working in Streamlit
        • Typical Project Setup
        • Your First Health Universe App
        • Streamlit Best Practices
      • Working in FastAPI
        • Typical Project Setup
        • Your First Health Universe App
        • Navigator FastAPI best practices
    • Deploying your app to Health Universe
      • Deploying to Health Universe
      • Secret Management
      • Connecting to an LLM
      • Connecting to an external data source
  • Testing your app
  • Re-deploying your app
  • Document your app
  • Deleting your App on Health Universe
  • Additional resources
    • Data Formats, Standards & Privacy
    • External Tools and Libraries
Powered by GitBook
On this page

Was this helpful?

  1. Building Apps in Health Universe
  2. Developing your Health Universe App
  3. Working in FastAPI

Navigator FastAPI best practices

PreviousYour First Health Universe AppNextDeploying your app to Health Universe

Last updated 22 days ago

Was this helpful?

Navigator is an AI-driven workflow automation tool that uses clinical, workflow and organizational context to anticipate tools and resources that can speed up administrative and clinical tasks. Once an app is identified and selected by the user, Navigator uses that context to autofill relevant fields.

Use the for a standardized, easy-to-implement structure to create apps that integrate smoothly with Navigator. They are designed to help you define clear, context-aware inputs and outputs, and to enhance autofill precision.

Describe your app accurately

Navigator uses the app’s title, description, and keywords to identify highly relevant matches. Make sure to include:

  • What the app is intended to do

  • Expected inputs and outputs

  • Best use cases within a clinical or administrative workflow

  • Tasks that typically occur before and after your app is used

Be as explicit with the input parameters as possible

Use dropdown lists whenever possible.

  • For example:

    • A dropdown with "Yes" or "No" is preferable to a free-text input where users type "yes" or "no."

    • For structured data like cancer staging, use dropdowns such as "Stage I, II, III, IV" or break down staging into components (e.g., stage, metastases presence).

Separate different concepts into separate input parameters

Each parameter should:

  • Have a clear, descriptive label

  • Represent a single type of data

For example, instead of a single field for "medications, problems, and allergies," create three separate fields. This improves autofill accuracy and clarity for users.

Minimum Quality Bars for Deploying an Application to Navigator

Before publishing your app to the Navigator environment, ensure it meets the following quality standards:

  • Timely Responses: Your app should return a result within 15 seconds to keep the workflow efficient. If it takes longer than this, then you may get a time out or navigator error.

  • Concise Output: Keep the response brief. If the output is verbose, use an LLM to summarize it before returning.

  • Concurrency Support: Your app must handle multiple user requests simultaneously — use techniques like unique IDs for ephemeral data or asynchronous operations.

  • Well-defined Metadata: Clearly define all fields, functions, titles, descriptions, and metadata. This ensures Navigator’s LLM can accurately surface and suggest your app in the appropriate workflow contexts.

Help improve Navigator

Navigator is still learning. If you notice unexpected behavior with input parameters or autofill suggestions, please report them so we can continue to improve the experience.

FastAPI template