AI Tasks Guide

AI Tasks are pre-configured AI prompts designed for common enterprise workflows. Each task includes:

• Optimized system prompts - Carefully crafted for specific use cases
• Variable templates - Dynamic inputs for customization (e.g., tone, audience, content)
• File support - Some tasks accept PDF, DOCX, or XLSX file uploads
• Safety controls - Automatic PHI detection and policy enforcement
• Cost estimation - Token usage and approximate cost per request

Basic request structure for AI tasks:

POST /api/ai/chat
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "conversationId": "new",  // or existing conversation ID
  "taskId": "meeting-summarizer",
  "variables": {
    "content": "Your meeting notes here..."
  },
  "temperature": 0.7  // optional: 0.0-1.0, default varies by task
}

Some tasks accept file uploads (PDF, DOCX, XLSX) for document-based processing:

// Step 1: Upload file
const formData = new FormData();
formData.append('file', fileInput.files[0]);

const uploadRes = await fetch('/api/files/upload', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' },
  body: formData
});
const { fileHash } = await uploadRes.json();

// Step 2: Process with AI task
const chatRes = await fetch('/api/ai/chat', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    conversationId: 'new',
    taskId: 'contract-summarizer',
    fileHash: fileHash  // Include file hash instead of content variable
  })
});

const result = await chatRes.json();
console.log(result.completion);

Each task defines required and optional variables. Common variable patterns:

Task processing times and costs vary by complexity:

* Estimates based on GPT-4o pricing. Actual costs vary by model and input length.

Tasks can be made available in the Guardian Health browser extension, allowing users to process selected text on any webpage.

Learn more in the Browser Extension Guide.