Medifontis
🇧🇷 PT
Obter chave de API

Documentação / Desenvolver

Agentes de IA e LLMs

Dê aos assistentes de IA uma ferramenta que busca registros oficiais de medicamentos, em vez de adivinhar a partir dos dados de treinamento.

Defina uma ferramenta de busca

Descreva o endpoint de busca como uma ferramenta. A maioria das APIs de modelos aceita um JSON Schema como este:

Definição da ferramenta 
{
  "name": "search_medicines",
  "description": "Search official medicine records of one country by brand name, active ingredient or national code. Returns records with their source, licence and limitations.",
  "input_schema": {
    "type": "object",
    "properties": {
      "country": {
        "type": "string",
        "description": "Two-letter lowercase country code, e.g. it, es, us."
      },
      "q": {
        "type": "string",
        "description": "Name, active ingredient or identifier, 3–120 characters."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 50
      }
    },
    "required": [
      "country",
      "q"
    ]
  }
}

Execute a ferramenta

Node.js 
export async function searchMedicines({ country, q, limit = 10 }) {
  const params = new URLSearchParams({ country, q, limit: String(limit) })
  const response = await fetch(`https://api.medifontis.com/v1/drugs?${params}`, {
    headers: { Authorization: `Bearer ${process.env.MEDIFONTIS_API_KEY}` },
  })
  if (!response.ok) return { error: (await response.json()).error }
  const { results } = await response.json()
  // Keep the fields a model needs, including where each record comes from.
  return results.map(({ name, identifiers, sourceId, sourceUrl, licence, limitations }) => ({
    name, identifiers, sourceId, sourceUrl, attribution: licence?.attribution, limitations,
  }))
}

Diretrizes de fundamentação

  • Cite a fonte e sua atribuição em toda resposta que usar um registro.
  • Nunca apresente um registro como orientação de prescrição ou prova de disponibilidade.
  • Use identificadores, e não nomes, nas buscas seguintes.

Documentação legível por máquina

O contrato completo está disponível no formato OpenAPI 3.1, e há um resumo para modelos de linguagem em /llms.txt.