Agente de IA para Gestão de Medicamentos em Internação

Consolidar a prescrição e o contexto clínico do paciente em um JSON padronizado e pronto para verificação clínica e consulta de estoque.

1.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente é o ponto de partida do fluxo e deve ser acionado pelo envio de um objeto JSON com dados da prescrição e do paciente via API. Na fase de testes, o fluxo será iniciado pelo envio manual dos dados, que serão enviados para o agente diretamente por upload do JSON na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um objeto JSON contendo dados detalhados sobre o paciente e a prescrição médica.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 20.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON, contendo a prescrição normalizada e flags para verificação clínica e de estoque. A estrutura deve seguir o exemplo fornecido no prompt.
• Exemplo de Estrutura de Output:

   {
    "prescricao_normalizada": {
      "paciente": {
        "id": "",
        "idade": 0,
        "peso_kg": 0,
        "sexo": ""
      },
      "itens": [
        {
          "med_id": {
            "rxnorm": "",
            "atc": ""
          },
          "nome_normalizado": "",
          "via": "",
          "forma": "",
          "dose_valor": 0,
          "dose_unidade": "mg|g|mcg|mL|U",
          "frequencia_padrao": "q8h|BID|TID|...",
          "duracao_horas": 0,
          "integridade_minima_ok": true
        }
      ]
    },
    "flags": {
      "requires_interaction_check": true,
      "requires_stock_check": true
    }
  } 

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 3.500 caracteres.

1.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

1.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

1.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Preparação para Chamada à API - Verificação de Interações e Dose (RF 2).

1.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Preparação para Chamada à API - Verificação de Interações e Dose (RF 2).

Preparar o payload para a API de base de fármacos que verifica interações medicamentosas, alergias, duplicidades terapêuticas e adequação de dose.

2.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 1), somente se a flag requires_interaction_check for verdadeira.
• Tipo do input: Este agente deve ser apto a receber como input um JSON contendo a prescrição normalizada do paciente.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 3.500 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado conforme o schema da API de base de fármacos, pronto para a chamada externa.
• Exemplo de Estrutura de Output:

   {
    "patient": {
      "age": 0,
      "sex": "M|F",
      "weight_kg": 0,
      "eGFR": 0,
      "hepatic_function": "A|B|C",
      "allergies": [
        "penicillin",
        "..."
      ]
    },
    "medications": [
      {
        "name": "",
        "rxnorm": "",
        "atc": "",
        "route": "VO|IV|...",
        "dose": {
          "value": 0,
          "unit": "mg|g|mcg|mL|U"
        },
        "frequency": "q8h|BID|..."
      }
    ],
    "context": {
      "diagnoses": [
        ""
      ],
      "care_setting": "ICU|Ward"
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 2.500 caracteres.

2.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

2.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

2.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Execução de Chamada à API - Base de Fármacos (RF 3).

2.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Execução de Chamada à API - Base de Fármacos (RF 3).

Realizar chamada à API do Sistema Base de Fármacos para obter análise de interações, alergias, duplicidade e checagem de dose.

3.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 2), somente se a flag requires_interaction_check for verdadeira.
• Tipo do input: Este agente deve ser apto a receber como input um payload JSON estruturado para a chamada à API de base de fármacos.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 2.500 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser os dados recuperados na chamada à API, contendo uma lista de issues por medicamento, conforme descrito no exemplo de output.
• Exemplo de Estrutura de Output: Dados recuperados na chamada à API contendo lista de issues por medicamento (interaction_severity, interaction_pairs, max_dose, renal_adjustment, hepatic_adjustment, duplicate_therapy, allergy_contraindication, route_mismatch, warnings).
• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 4.000 caracteres.

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: Não se aplica (uso de ferramenta)

3.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o JSON recebido para a API externa do Sistema Base de Fármacos e retornar os dados recebidos como resposta.

3.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Análise Clínica da Prescrição (RF 4).

3.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Análise Clínica da Prescrição (RF 4).

Analisar o retorno da Base de Fármacos e qualificar discrepâncias de dose, interações e alergias, com recomendações acionáveis.

4.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 3).
• Tipo do input: Este agente deve ser apto a receber dois artefatos como input: o retorno bruto da API da Base de Fármacos e o JSON normalizado da prescrição.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar uma soma de inputs de até 8.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado contendo a análise clínica da prescrição, conforme o exemplo fornecido.
• Exemplo de Estrutura de Output:

   {
    "analise_clinica": {
      "itens": [
        {
          "med_id": {
            "rxnorm": ""
          },
          "problemas": [
            {
              "tipo": "interacao|dose_inadequada|alergia|duplicidade|via_inadequada|dados_incompletos|outro",
              "severidade": "baixa|moderada|alta|contraindicada",
              "descricao": "",
              "pares_envovidos": [
                "med1",
                "med2"
              ],
              "acao_recomendada": "ajustar_dose|substituir|monitorar|suspender",
              "referencia": ""
            }
          ]
        }
      ],
      "resumo": {
        "qtde_itens_com_problema": 0,
        "itens_com_alta_severidade": 0
      }
    },
    "relatorio_markdown": "# Avaliação Clínica da Prescrição\n..."
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 4.500 caracteres.

4.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

4.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

4.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Preparação para Chamada à API - Consulta de Estoque de Medicamentos (RF 5).

4.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Preparação para Chamada à API - Consulta de Estoque de Medicamentos (RF 5).

Preparar o payload para consulta de saldo e posição de estoque dos medicamentos prescritos no sistema de farmácia/ERP.

5.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 4), somente se a flag requires_stock_check for verdadeira.
• Tipo do input: Este agente deve ser apto a receber como input um JSON normalizado da prescrição, contendo as quantidades necessárias para 24 horas de cada medicamento.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 3.500 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado conforme o schema do sistema de farmácia/ERP, pronto para a chamada externa.
• Exemplo de Estrutura de Output:

   {
    "items": [
      {
        "codigo": {
          "rxnorm": "",
          "atc": ""
        },
        "nome": "",
        "quantidade_necessaria_unidade": 0,
        "unidade": "mg|mL|U",
        "horizonte_horas": 24
      }
    ],
    "setor": "Farmacia_Central|UTI_A|Enfermaria_B"
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 2.500 caracteres.

5.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

5.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

5.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Execução de Chamada à API - ERP/Estoque Farmácia (RF 6).

5.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Execução de Chamada à API - ERP/Estoque Farmácia (RF 6).

Realizar chamada à API do ERP/Farmácia para obter saldos, lotes e pontos de ressuprimento.

6.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 5), somente se a flag requires_stock_check for verdadeira.
• Tipo do input: Este agente deve ser apto a receber como input um payload JSON estruturado para a chamada à API do ERP/Farmácia.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 2.500 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser os dados brutos de estoque por item, conforme descrito no exemplo de output.
• Exemplo de Estrutura de Output: Dados brutos de estoque por item (saldo_atual, unidade, ponto_pedido, lote, validade, localizacao, status_compra_em_andamento).
• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 4.000 caracteres.

6.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: Não se aplica (uso de ferramenta)

6.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o JSON recebido para a API externa do ERP/Farmácia e retornar os dados recebidos como resposta.

6.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Reconciliação de Estoque e Sugestões (RF 7).

6.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Reconciliação de Estoque e Sugestões (RF 7).

Comparar necessidade estimada com posição de estoque e sugerir ações (dispensação, fracionamento, substituição terapêutica equivalente ou acionamento de ressuprimento).

7.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 6).
• Tipo do input: Este agente deve ser apto a receber dois artefatos como input: o retorno bruto da API de estoque e o JSON normalizado da prescrição com quantidades necessárias para 24 horas.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar uma soma de inputs de até 8.000 caracteres.

7.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado contendo a reconciliação de estoque e sugestões de ação, conforme o exemplo fornecido.
• Exemplo de Estrutura de Output:

   {
    "estoque": {
      "itens": [
        {
          "nome": "",
          "necessario_24h": 0,
          "saldo": 0,
          "status": "disponivel|baixo|indisponivel",
          "acao": "dispensar|fracionar|substituir|ressuprir",
          "observacao": ""
        }
      ]
    },
    "relatorio_markdown": "# Status de Estoque\n..."
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 4.500 caracteres.

7.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

7.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

7.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Síntese Final e Geração de Alertas (RF 8).

7.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Síntese Final e Geração de Alertas (RF 8).

Unificar análise clínica e reconciliação de estoque em um output final estruturado e mensagem de alerta para a equipe.

8.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 7).
• Tipo do input: Este agente deve ser apto a receber dois artefatos como input: a saída do Agente de Análise Clínica da Prescrição e a saída do Agente de Reconciliação de Estoque.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar uma soma de inputs de até 8.000 caracteres.

8.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado contendo o resultado final da análise clínica e de estoque, além de uma mensagem de alerta em formato markdown.
• Exemplo de Estrutura de Output:

   {
    "resultado_final": {
      "prescricao_valida": true,
      "alertas": [
        {
          "tipo": "clinico|estoque",
          "severidade": "baixa|moderada|alta|contraindicada",
          "descricao": "",
          "acao_recomendada": ""
        }
      ],
      "acoes_operacionais": [
        {
          "item": "",
          "acao": "dispensar|ajustar_dose|substituir|ressuprir",
          "prioridade": "alta|media|baixa"
        }
      ]
    },
    "mensagem_markdown": "# Alertas da Prescrição\n..."
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 4.500 caracteres.

8.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

8.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

8.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta (JSON final) é o entregável final e não é passada para outros agentes internos.

8.3.6 Regras de Orquestração e Transição

A execução deste agente finaliza o fluxo. O resultado final é disponibilizado para a equipe médica e de farmácia.