Información de Tratamientos

Esta guía explica cómo consultar información médica sobre tratamientos utilizando la API del sistema de agentes.

Endpoint

POST /api/treatments

Autenticación

La API requiere una clave de API válida que debe enviarse en uno de los siguientes headers:

• Authorization: Bearer {api_key}
• x-api-key: {api_key}

API Key de Ejemplo

<API_TOKEN>

Estructura de la Petición

Headers Requeridos

Content-Type: application/json
Authorization: Bearer <API_TOKEN>

Body de la Petición

{
  "question": "string"
}

Parámetros

Ejemplos de Uso

Ejemplo 1: Consulta Básica sobre Tratamiento

curl -X POST https://dev-agents.hal.onl/api/treatments \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API_TOKEN>" \
  -d '{
    "question": "¿Cuál es el tratamiento para la hipertensión arterial?"
  }'

Ejemplo 2: Consulta sobre Medicamentos Específicos

curl -X POST https://dev-agents.hal.onl/api/treatments \
  -H "Content-Type: application/json" \
  -H "x-api-key: <API_TOKEN>" \
  -d '{
    "question": "¿Qué medicamentos se usan para tratar la diabetes tipo 2?"
  }'

Ejemplo 3: Consulta sobre Efectos Secundarios

curl -X POST https://dev-agents.hal.onl/api/treatments \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API_TOKEN>" \
  -d '{
    "question": "¿Cuáles son los efectos secundarios del metformina?"
  }'

Ejemplo 4: Usando JavaScript

const getTreatmentInfo = async (question) => {
  const response = await fetch('https://dev-agents.hal.onl/api/treatments', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      Authorization: 'Bearer <API_TOKEN>',
    },
    body: JSON.stringify({
      question,
    }),
  })

  if (!response.ok) {
    throw new Error(`Error: ${response.status}`)
  }

  return await response.json()
}

// Uso básico
const result = await getTreatmentInfo('¿Cómo se trata la gripe?')

// Otro ejemplo
const result2 = await getTreatmentInfo('¿Qué precauciones debo tener después de una cirugía?')

Ejemplo 5: Usando Python

import requests
import json

def get_treatment_info(question):
    url = 'https://dev-agents.hal.onl/api/treatments'
    headers = {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer <API_TOKEN>'
    }

    payload = {'question': question}

    response = requests.post(url, headers=headers, json=payload)

    if response.status_code == 200:
        return response.json()
    else:
        raise Exception(f'Error {response.status_code}: {response.text}')

# Uso
result = get_treatment_info('¿Cuál es el tratamiento para la depresión?')

Respuestas

Respuesta Exitosa (200 OK)

{
  "success": true,
  "data": {
    "message": "El tratamiento para la hipertensión arterial generalmente incluye cambios en el estilo de vida y medicamentos. Los cambios incluyen reducir el consumo de sal, hacer ejercicio regularmente, mantener un peso saludable y limitar el alcohol. Los medicamentos comunes incluyen: inhibidores de la ECA (como enalapril), bloqueadores de los receptores de angiotensina II (como losartán), diuréticos (como hidroclorotiazida), bloqueadores de los canales de calcio (como amlodipino) y betabloqueantes (como metoprolol). Es importante consultar con un médico para determinar el tratamiento más adecuado para cada caso individual.",
    "sources": [
      {
        "title": "Guías de hipertensión 2023",
        "url": "https://example.com/hypertension-guidelines",
        "chunk": "Tratamiento de la hipertensión arterial..."
      }
    ],
    "metrics": {
      "tokens": {
        "input": 45,
        "output": 234
      },
      "processingTime": 2.3,
      "model": "gpt-4"
    }
  }
}

Campos de la Respuesta

Códigos de Error

400 Bad Request

{
  "success": false,
  "error": "question es requerido"
}

401 Unauthorized

{
  "success": false,
  "error": "API key requerida en header Authorization o x-api-key"
}

{
  "success": false,
  "error": "API key inválida"
}

502 Bad Gateway

{
  "success": false,
  "error": "Error al procesar la solicitud"
}

500 Internal Server Error

{
  "success": false,
  "error": "Error interno del servidor"
}

Consideraciones Especiales

• El sistema utiliza un workspace específico de AnythingLLM para tratamientos médicos
• Las consultas se procesan en tiempo real mediante IA
• La información proporcionada es de carácter general y no sustituye el consejo médico profesional
• Siempre se deben consultar fuentes médicas confiables y profesionales de la salud para tratamientos específicos