1. Propósito e Escopo
Este documento define todos os prompts, configurações de memória, transição entre estados, consulta a documentos e demais requisitos funcionais para o Fluxo de Agentes "Análise de Efetividade de Tratamentos no Pronto Atendimento", uma solução projetada para avaliar a efetividade dos tratamentos realizados no pronto atendimento e sugerir melhorias. Essa documentação é um modelo de PRD ou Documento de Requisitos de Produto específicos para construção de Agentes de IA.
O objetivo principal é transformar dados brutos de tratamentos em insights acionáveis que melhorem a qualidade e eficiência do atendimento, reduzindo a variabilidade e aumentando a confiança nas decisões clínicas.
2. Contexto e Problema
Cenário Atual
No ambiente de pronto atendimento, a avaliação da efetividade dos tratamentos é frequentemente inadequada devido à falta de dados padronizados e análises robustas. Isso resulta em uma incapacidade de identificar áreas específicas onde melhorias poderiam ser implementadas.
- Avaliação inadequada da efetividade dos tratamentos realizados no pronto atendimento.
- Falta de sugestões baseadas em dados para melhorias nos tratamentos.
Problemas Identificados
- Dados não padronizados: A ausência de um formato consistente para os dados dificulta a análise e a comparação.
- Falta de insights acionáveis: A ausência de análises detalhadas impede a implementação de melhorias baseadas em evidências.
- Variabilidade nos tratamentos: A falta de padronização leva a inconsistências nos cuidados prestados.
3. Impactos Esperados
A implementação deste fluxo de automação visa alcançar os seguintes resultados:
- Melhoria na qualidade dos dados por meio da padronização e consistência.
- Aumento da efetividade dos tratamentos através de insights baseados em dados.
- Redução da variabilidade nos tratamentos através de recomendações padronizadas.
- Suporte à decisão clínica com base em evidências e métricas claras.
4. Visão Geral da Solução
O agente de IA para análise de efetividade de tratamentos no pronto atendimento processa dados de atendimentos, avalia a efetividade dos tratamentos e sugere melhorias baseadas em dados. A seguir são detalhadas todas as regras de negócio e especificações funcionais necessárias para que esse agente atue como um assistente útil e autônomo na melhoria dos tratamentos no pronto atendimento.
A solução consiste em um fluxo de automação composto por 4 agentes de IA. O processo inicia com a preparação e qualidade de dados e termina com a geração de um plano de melhoria detalhado.
A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.
| Agentes | Função Principal |
|---|---|
Agente de Preparação e Qualidade de Dados de Tratamentos (RF 1)
| Receber dados brutos do pronto atendimento e produzir um dataset padronizado, consistente e auditável. |
Agente de Cálculo de Métricas de Efetividade (RF 2)
| Calcular métricas padronizadas de efetividade e eficiência por condição e por tratamento. |
Agente de Benchmarking e Identificação de Oportunidades (RF 3)
| Comparar o desempenho entre pares internos e identificar grupos com performance abaixo do esperado. |
Agente de Recomendações e Plano de Melhoria (RF 4)
| Transformar oportunidades em recomendações priorizadas, com plano de ação, impacto esperado e monitoramento. |
5. Protótipos
Para proporcionar uma visão clara e tangível da solução proposta, criamos protótipos interativos que demonstram tanto o fluxo de trabalho dos agentes quanto o resultado final que o cliente receberá. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Preparação e Qualidade de Dados de Tratamentos
1.1 Tarefa do Agente
Receber dados brutos do pronto atendimento e produzir um dataset padronizado, consistente e auditável para análise de efetividade.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados brutos de tratamentos realizados no pronto atendimento. Esses dados incluem informações variadas sobre o atendimento ao paciente.
# 2. Objetivo
Padronizar e preparar os dados para análise, garantindo consistência e qualidade para avaliação da efetividade dos tratamentos.
# 3. Regras que você deve seguir para gerar sua resposta
- Analise e padronize os campos obrigatórios, como atendimento_id, data_hora_chegada, e diagnostico_principal.
- Converta todos os timestamps para o formato ISO 8601.
- Padronize diagnósticos para CID10 quando possível.
- Resolva duplicidades e outliers nos registros.
- Gere um resumo da qualidade dos dados, incluindo registros válidos e excluídos.
# 4. Exemplo de Output que você deve produzir
{
"standardized_records": [],
"data_quality_summary": {
"total_registros": 1000,
"registros_validos": 950,
"registros_excluidos_por_motivo": {}
}
} 1.3 Configurações do Agente
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 arquivo com dados brutos de atendimentos 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 de um csv na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo é um arquivo contendo dados brutos de atendimentos.
-
Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos:
.csv,.json. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 1.000.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um arquivo no formato JSON contendo registros padronizados e um resumo da qualidade dos dados.
-
Exemplo de Estrutura de Output:
{ "standardized_records": [], "data_quality_summary": { "total_registros": 1000, "registros_validos": 950, "registros_excluidos_por_motivo": {} } } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 10.000 caracteres, variando de acordo com o volume de dados processados.
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: Utiliza lógica interna para cálculos de qualidade de dados.
- 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 Cálculo de Métricas de Efetividade (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Cálculo de Métricas de Efetividade (RF 2).
RF 2. Agente de Cálculo de Métricas de Efetividade
2.1 Tarefa do Agente
Calcular métricas padronizadas de efetividade e eficiência por condição e por tratamento, com estratificações relevantes.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um dataset padronizado de tratamentos do pronto atendimento, pronto para análise de efetividade.
# 2. Objetivo
Calcular métricas de efetividade e eficiência para cada condição e tratamento, identificando áreas de melhoria potencial.
# 3. Regras que você deve seguir para gerar sua resposta
- Defina 'sucesso clínico' como desfecho de alta sem complicações subsequentes.
- Agrupe dados por condição e tratamento para análise detalhada.
- Calcule taxas de sucesso clínico, retorno em 72h, internação em 7 dias e óbito em 7 dias.
- Forneça notas metodológicas sobre critérios de inclusão e exclusão.
# 4. Exemplo de Output que você deve produzir
{
"metrics_by_group": [
{
"group": "asma",
"n": 100,
"sucesso_clinico_rate": 90,
"retorno_72h_rate": 5,
"internacao_7d_rate": 3,
"obito_7d_rate": 0
}
]
} 2.3 Configurações do Agente
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).
- Tipo do input: Este agente deve ser apto a receber como input um JSON contendo registros padronizados e um resumo da qualidade dos dados.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato:
.json. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 50.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um arquivo no formato JSON contendo métricas de efetividade por grupo de condição e tratamento.
-
Exemplo de Estrutura de Output:
{ "metrics_by_group": [ { "group": "asma", "n": 100, "sucesso_clinico_rate": 90, "retorno_72h_rate": 5, "internacao_7d_rate": 3, "obito_7d_rate": 0 } ] } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.000 caracteres, variando de acordo com o número de grupos analisados.
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: Utiliza lógica interna para cálculos de métricas.
- 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 Benchmarking e Identificação de Oportunidades (RF 3).
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Benchmarking e Identificação de Oportunidades (RF 3).
RF 3. Agente de Benchmarking e Identificação de Oportunidades
3.1 Tarefa do Agente
Comparar o desempenho entre pares internos e identificar grupos com performance abaixo do esperado, sugerindo hipóteses de causa.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo métricas de efetividade de tratamentos, prontas para análise comparativa e identificação de oportunidades de melhoria.
# 2. Objetivo
Identificar grupos de tratamento com desempenho abaixo do esperado e sugerir hipóteses de causa e oportunidades de melhoria.
# 3. Regras que você deve seguir para gerar sua resposta
- Compare cada grupo com a mediana interna do mesmo nível de triagem.
- Identifique grupos com sucesso clínico abaixo da mediana por mais de 5 pontos percentuais.
- Sugira hipóteses de causa baseadas em dados disponíveis.
# 4. Exemplo de Output que você deve produzir
{
"opportunities": [
{
"group_id": "asma",
"indicador_critico": "sucesso_clinico_rate",
"valor_atual": 80,
"referencia": 90,
"desvio_pp": 10,
"prioridade": "alta"
}
]
} 3.3 Configurações do Agente
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).
- Tipo do input: Este agente deve ser apto a receber como input um JSON contendo métricas de efetividade por grupo de condição e tratamento.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato:
.json. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 10.000 caracteres.
3.3.2 Especificação do Output
- Formato de output: O output deve ser um arquivo no formato JSON contendo oportunidades de melhoria para cada grupo analisado.
-
Exemplo de Estrutura de Output:
{ "opportunities": [ { "group_id": "asma", "indicador_critico": "sucesso_clinico_rate", "valor_atual": 80, "referencia": 90, "desvio_pp": 10, "prioridade": "alta" } ] } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 3.000 caracteres, variando de acordo com o número de oportunidades identificadas.
3.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.6
3.3.4 Ferramentas do Agente
- Documentos: Não consulta.
- Calculadora: Utiliza lógica interna para cálculos comparativos.
- Busca Online: Não utiliza.
- Sistemas Externos: Não utiliza.
3.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 Recomendações e Plano de Melhoria (RF 4).
3.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Recomendações e Plano de Melhoria (RF 4).
RF 4. Agente de Recomendações e Plano de Melhoria
4.1 Tarefa do Agente
Transformar oportunidades em recomendações priorizadas, com plano de ação, impacto esperado e monitoramento.
4.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo oportunidades de melhoria identificadas a partir de dados de efetividade de tratamentos.
# 2. Objetivo
Desenvolver recomendações concretas e priorizadas para melhorar a efetividade dos tratamentos, incluindo plano de ação e monitoramento.
# 3. Regras que você deve seguir para gerar sua resposta
- Para cada oportunidade, crie um plano de ação detalhado com passos operacionais claros.
- Priorize recomendações por impacto e esforço, focando em alto impacto com esforço moderado.
- Inclua métricas de monitoramento para avaliar a implementação das recomendações.
# 4. Exemplo de Output que você deve produzir
{
"recommendations": [
{
"titulo": "Melhoria no tratamento da asma",
"objetivo": "Reduzir o tempo de porta-tratamento em 15 minutos",
"passos_operacionais": ["Revisar protocolo de triagem", "Implementar fast-track para asma"],
"impacto_esperado": "Redução de 15 minutos",
"esforco": "médio"
}
]
} 4.3 Configurações do Agente
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 como input um JSON contendo oportunidades de melhoria para cada grupo analisado.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato:
.json. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 5.000 caracteres.
4.3.2 Especificação do Output
- Formato de output: O output deve ser um arquivo no formato JSON contendo recomendações priorizadas e planos de ação detalhados para cada oportunidade.
-
Exemplo de Estrutura de Output:
{ "recommendations": [ { "titulo": "Melhoria no tratamento da asma", "objetivo": "Reduzir o tempo de porta-tratamento em 15 minutos", "passos_operacionais": ["Revisar protocolo de triagem", "Implementar fast-track para asma"], "impacto_esperado": "Redução de 15 minutos", "esforco": "médio" } ] } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 2.000 caracteres, variando de acordo com o número de recomendações desenvolvidas.
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: Utiliza lógica interna para priorização de recomendações.
- Busca Online: Não utiliza.
- Sistemas Externos: Não utiliza.
4.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 é o entregável final e não é passada para outros agentes internos.
4.3.6 Regras de Orquestração e Transição
A execução deste agente finaliza o fluxo. As recomendações geradas são o resultado que deve ser disponibilizado ao usuário.