Skip to main content

Tools & Toolkits — Available Capabilities

Tools​

get_fhir_resource_by_id​

  • Description: Get a specific FHIR resource by ID
  • Config:
    • serverUrl (string, required): FHIR server base URL
    • version (string, required, default: R4): FHIR version
    • authToken (string, optional): Bearer token
    • clientId (string, optional): Client ID
  • Active: true

list_fhir_resources​

  • Description: List FHIR resources of a specific type
  • Config:
    • serverUrl (string, required)
    • version (string, required, default: R4)
    • authToken (string, optional)
    • clientId (string, optional)
  • Active: true

search_fhir_resources​

  • Description: Search FHIR resources with query parameters
  • Config:
    • serverUrl (string, required)
    • version (string, required, default: R4)
    • authToken (string, optional)
    • clientId (string, optional)
  • Active: true
  • Description: Search uploaded files or knowledge sources
  • Notes: Useful for RAG and document retrieval

websearch​

  • Description: Search the web for supplemental information
  • Notes: Disabled by default in clinical environments unless explicitly enabled

Toolkits​

Toolkits are curated collections of tools intended to be enabled together for a task domain.

FHIR Access Toolkit​

  • Includes:
    • get_fhir_resource_by_id
    • list_fhir_resources
    • search_fhir_resources
  • Use cases: Patient summary, chart review, CDS

Knowledge Retrieval Toolkit​

  • Includes:
    • file_search
  • Use cases: RAG workflows, research assistants, guideline-aware agents

Web Enrichment Toolkit (optional)​

  • Includes:
    • websearch
  • Use cases: Non-clinical enrichment, external sourcing (opt-in)

Example: Enabling Tools in a Worker​

import { EngineClient } from '@boolbyte/engine';

const client = new EngineClient({ apiKey: 'YOUR_API_KEY' });

const worker = await client.worker.createWorker({
  name: 'ehr-summarizer',
  defaultModelName: 'medgemma-27b',
  instructions: 'Summarize the patient\'s recent observations and visit notes.',
  toolConfigs: {
    tools: [
      {
        toolName: 'fhir_access',
        config: { serverId: 'your-fhir-server-id' }
      }
    ],
    toolkits: [
      { toolkitName: 'knowledge-retrieval' }
    ]
  }
});

Notes​

  • Tools can require server configuration and authentication context
  • Toolkits serve as convenience bundles; individual tools can be enabled directly
  • In clinical contexts, websearch should be explicitly enabled and reviewed