1. Propósito e Escopo
Este documento define todos os prompts, configurações de memória, transição entre estados, ferramentas como chamadas a sistemas externos e demais requisitos funcionais para o Fluxo de Agentes "Processamento de Autorizações de Vale-Saúde", uma solução projetada para automatizar o recebimento, verificação e aprovação de autorizações de procedimentos de saúde. 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 é garantir conformidade com as políticas da administradora, reduzindo o tempo de resposta e minimizando erros no processo de aprovação de autorizações de saúde.
2. Contexto e Problema
Cenário Atual
O atual processo de autorização de procedimentos de saúde é manual, demorado e sujeito a erros. Isso resulta em atrasos na aprovação, insatisfação dos beneficiários e potenciais riscos de não conformidade com regulamentos.
- Processos manuais demorados e sujeitos a erros na verificação de autorizações de saúde.
- Conformidade com políticas e regulamentos que exigem verificação minuciosa.
- Necessidade de rápido tempo de resposta para aprovações de procedimentos de saúde.
Problemas Identificados
- Consumo de tempo: O processo manual de verificação e aprovação é lento e consome recursos significativos.
- Risco de não conformidade: A falta de verificação minuciosa pode resultar em violações de regulamentos.
- Insatisfação do usuário: Atrasos nas aprovações causam insatisfação dos beneficiários e prestadores.
3. Impactos Esperados
A implementação deste fluxo de automação visa alcançar os seguintes resultados:
- Redução do tempo de processamento das autorizações em pelo menos 70%.
- Aumento da conformidade com políticas e regulamentos internos e externos.
- Melhoria na satisfação dos beneficiários e prestadores com tempos de resposta mais rápidos.
4. Visão Geral da Solução
O agente de IA para processamento de autorizações de vale-saúde recebe e verifica automaticamente os documentos de autorização, aplica regras predefinidas para aprovação ou rejeição e atualiza o status em tempo real. 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 gestão de autorizações de saúde.
A solução consiste em um fluxo de automação composto por 7 agentes de IA. O processo inicia com a recepção do documento de autorização e termina com a notificação do status da autorização para todas as partes envolvidas.
A execução dos agentes é sequencial, seguindo a ordem definida na tabela abaixo.
| Agentes | Função Principal |
|---|---|
Agente de Extração de Dados do Documento de Autorização (RF 1)
| Extrair e estruturar dados necessários para avaliação de autorização. |
Agente de Preparação de Parâmetros para Consulta de Políticas (RF 2)
| Transformar dados extraídos em consultas objetivas às políticas relevantes. |
Agente de Execução de Consulta a Documento (RF 3)
| Consultar bases documentais para obter trechos normativos aplicáveis. |
Agente de Verificação de Autorizações (RF 4)
| Validar conformidade técnica e administrativa da autorização. |
Agente de Decisão de Aprovação de Autorizações (RF 5)
| Emitir decisão automatizada com fundamentação objetiva. |
Agente de Execução de Chamada à API - Atualização de Status (RF 6)
| Registrar o status e a decisão da autorização no sistema da administradora. |
Agente de Execução de Chamada à API - Notificações (RF 7)
| Disparar notificações para beneficiário e prestador com o resultado da autorização. |
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 Extração de Dados do Documento de Autorização
1.1 Tarefa do Agente
Extrair e estruturar, a partir de PDF/imagem da guia/solicitação, todos os dados necessários para avaliação de autorização.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um documento de autorização em formato PDF ou imagem. Este documento contém informações essenciais para a avaliação de autorização de procedimentos de saúde.
# 2. Objetivo
Extrair e estruturar todos os dados necessários para a correta avaliação da autorização, garantindo que todos os campos obrigatórios sejam capturados e formatados adequadamente.
# 3. Regras que você deve seguir para gerar sua resposta
- Certifique-se de que todos os campos obrigatórios sejam extraídos, incluindo dados do beneficiário, prestador, procedimentos e anexos.
- Estruture os dados extraídos em um formato JSON conforme o modelo fornecido.
- Valide a integridade dos dados, garantindo que não haja campos faltantes ou inconsistências.
# 4. Exemplo de Output que você deve produzir
{
"documento_processado": true,
"campos_extraidos": {
"id_autorizacao": "string|null",
"beneficiario": {
"nome": "string",
"cpf": "string|null",
"numero_carteira": "string",
"plano": "string"
},
"prestador": {
"nome": "string",
"cnpj_cpf": "string",
"registro_conselho": "string|null",
"codigo_credenciamento": "string|null"
},
"solicitacao": {
"data_solicitacao": "YYYY-MM-DD",
"cid10": ["string"],
"procedimentos": [
{
"codigo_tuss": "string",
"descricao": "string",
"quantidade": number,
"via": "string|null"
}
],
"materiais_medicamentos": [
{
"codigo": "string",
"descricao": "string",
"quantidade": number,
"unidade": "string"
}
]
},
"anexos_presentes": ["guia_tiss", "pedido_medico", "relatorio_clinico", "exames_complementares"],
"assinaturas": {
"solicitante": true,
"beneficiario": true
},
"metadados_documento": {
"tipo": "tiss|livre",
"paginas": number
}
}
} 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 documento de autorização em formato PDF ou imagem 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 documento na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo é um documento de autorização, que após ser processado, resulta em um JSON com os dados extraídos.
-
Formatos Suportados: Esse agente deve ser capaz de receber documentos nos formatos:
.pdf,.jpg,.png. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 50.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um arquivo no formato JSON contendo os dados extraídos e estruturados conforme o modelo especificado no prompt.
-
Exemplo de Estrutura de Output:
{ "documento_processado": true, "campos_extraidos": { "id_autorizacao": "string|null", "beneficiario": { "nome": "string", "cpf": "string|null", "numero_carteira": "string", "plano": "string" }, "prestador": { "nome": "string", "cnpj_cpf": "string", "registro_conselho": "string|null", "codigo_credenciamento": "string|null" }, "solicitacao": { "data_solicitacao": "YYYY-MM-DD", "cid10": ["string"], "procedimentos": [ { "codigo_tuss": "string", "descricao": "string", "quantidade": number, "via": "string|null" } ], "materiais_medicamentos": [ { "codigo": "string", "descricao": "string", "quantidade": number, "unidade": "string" } ] }, "anexos_presentes": ["guia_tiss", "pedido_medico", "relatorio_clinico", "exames_complementares"], "assinaturas": { "solicitante": true, "beneficiario": true }, "metadados_documento": { "tipo": "tiss|livre", "paginas": number } } } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 3.000 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 de Parâmetros para Consulta de Políticas (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 de Parâmetros para Consulta de Políticas (RF 2).
RF 2. Agente de Preparação de Parâmetros para Consulta de Políticas
2.1 Tarefa do Agente
Transformar os dados extraídos em consultas objetivas às políticas e normativos (internos e regulatórios) relevantes ao caso.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um JSON com os campos extraídos do documento de autorização. Este JSON contém informações detalhadas sobre o beneficiário, prestador, procedimentos e contexto clínico.
# 2. Objetivo
Transformar os dados extraídos em consultas objetivas às políticas e normativos relevantes, garantindo que todas as diretrizes e regras aplicáveis sejam consideradas.
# 3. Regras que você deve seguir para gerar sua resposta
- Para cada procedimento, gere termos de busca que combinem código TUSS, descrição, CID-10 e plano do beneficiário.
- Inclua consultas para cobertura do plano, carência, diretrizes de utilização (DUT) do Rol ANS, limites quantitativos e de frequência, e exigência de autorização prévia/auditoria.
- Se houver materiais especiais/medicamentos de alto custo, inclua consulta específica de OPME/alto custo e necessidade de laudo.
- Se prestador for não credenciado ou campo ausente, inclua consulta sobre regras de reembolso e atendimentos fora de rede.
- Se o tipo de atendimento indicar urgência/emergência, inclua consulta sobre exceções de carência e autorização retroativa.
# 4. Exemplo de Output que você deve produzir
{
"consultas_politicas": [
{
"topico": "cobertura_plano",
"termos_busca": ["plano X cobertura", "rede credenciada"],
"escopo": "políticas internas"
},
{
"topico": "carencias",
"termos_busca": ["carência procedimentos código TUSS"],
"escopo": "políticas internas"
},
{
"topico": "rol_ans_dut",
"termos_busca": ["ROL ANS código TUSS", "DUT CID"],
"escopo": "normas regulatórias"
},
{
"topico": "limites_quantitativos",
"termos_busca": ["limite sessões/ano código TUSS"],
"escopo": "políticas internas"
}
]
} 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 os campos extraídos do documento de autorização.
-
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é 6.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um arquivo no formato JSON contendo as consultas de políticas geradas a partir dos dados extraídos.
-
Exemplo de Estrutura de Output:
{ "consultas_politicas": [ { "topico": "cobertura_plano", "termos_busca": ["plano X cobertura", "rede credenciada"], "escopo": "políticas internas" }, { "topico": "carencias", "termos_busca": ["carência procedimentos código TUSS"], "escopo": "políticas internas" } ] } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.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 documentos externos.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Não se conecta a sistemas externos.
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 Consulta a Documento (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 Consulta a Documento (RF 3).
RF 3. Agente de Execução de Consulta a Documento
3.1 Tarefa do Agente
Realizar consulta às bases documentais (políticas internas, manuais de credenciamento, tabelas de cobertura e normativos regulatórios) para obter trechos normativos aplicáveis.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo parâmetros de busca prontos em consultas_politicas, com termos, escopo e tópicos. Estes parâmetros são fundamentais para localizar e extrair trechos normativos aplicáveis nas bases documentais.
# 2. Objetivo
Realizar consulta às bases documentais relevantes para obter os trechos normativos aplicáveis aos casos em questão.
# 3. Regras que você deve seguir para gerar sua resposta
- Utilize os termos de busca fornecidos para localizar as informações relevantes nas bases documentais.
- Extraia trechos normativos que sejam diretamente aplicáveis aos casos, garantindo alta confiabilidade nas fontes.
- Registre as consultas que não retornaram resultados e identifique áreas que necessitam de atenção adicional.
# 4. Exemplo de Output que você deve produzir
{
"resultados_consulta": [
{
"topico": "rol_ans_dut",
"fontes": [
{
"titulo": "ROL ANS 2025 - DUT",
"trecho": "string",
"referencia": "url|id_doc",
"confianca": 0.0-1.0
}
]
}
],
"consultas_sem_resultado": ["topico"]
} 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 os parâmetros de busca prontos em consultas_politicas.
-
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é 6.000 caracteres.
3.3.2 Especificação do Output
- Formato de output: O output deve ser um arquivo no formato JSON contendo os resultados das consultas realizadas e as consultas que não retornaram resultados.
-
Exemplo de Estrutura de Output:
{ "resultados_consulta": [ { "topico": "rol_ans_dut", "fontes": [ { "titulo": "ROL ANS 2025 - DUT", "trecho": "string", "referencia": "url|id_doc", "confianca": 0.0-1.0 } ] } ], "consultas_sem_resultado": ["topico"] } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 2.000 caracteres.
3.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.6
3.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.
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 Verificação de Autorizações (RF 4).
3.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Verificação de Autorizações (RF 4).
RF 4. Agente de Verificação de Autorizações
4.1 Tarefa do Agente
Validar conformidade técnica e administrativa da autorização confrontando dados extraídos com políticas aplicáveis.
4.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo os campos extraídos do documento e os resultados das consultas de políticas/normas. Estes dados são essenciais para verificar a conformidade técnica e administrativa da autorização.
# 2. Objetivo
Validar a autorização confrontando os dados extraídos com as políticas aplicáveis, garantindo que todos os critérios e exigências sejam atendidos.
# 3. Regras que você deve seguir para gerar sua resposta
- Verifique a identificação do beneficiário e elegibilidade com base nos dados fornecidos.
- Confirme a cobertura do plano e o cumprimento de carências, DUTs e limites quantitativos.
- Avalie a documentação obrigatória e a credencialidade do prestador.
- Normalize os códigos TUSS e CID-10 conforme os padrões estabelecidos.
- Calcule coparticipações quando aplicável e registre quaisquer pendências ou observações.
# 4. Exemplo de Output que você deve produzir
{
"autorizacao_verificada": true|false,
"checklist": {
"identificacao_beneficiario_valida": true|false,
"elegibilidade_vigente": true|false,
"plano_cobre_procedimento": true|false,
"carencia_cumprida": true|false,
"dut_atendida": true|false,
"limites_quantitativos_ok": true|false,
"documentacao_obrigatoria_ok": true|false,
"prestador_credenciado_ok": true|false,
"cid_compativel": true|false,
"integridade_documental_ok": true|false
},
"itens_analisados": [
{
"codigo_tuss": "string",
"quantidade_solicitada": number,
"quantidade_aprovavel": number,
"motivos_restricao": ["string"]
}
],
"normalizacoes": {
"tuss_normalizados": true,
"cid10_normalizados": true
},
"valores_calculados": {
"coparticipacao_percentual": number|null,
"coparticipacao_valor_estimado": number|null
},
"pendencias": ["string"],
"referencias_utilizadas": [{"topico": "string", "referencia": "url|id_doc"}],
"observacoes": "string"
} 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 dois conjuntos de dados: os campos extraídos do documento (JSON) e os resultados das consultas de políticas (JSON).
-
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 combinado de até 12.000 caracteres.
4.3.2 Especificação do Output
- Formato de output: O output deve ser um arquivo no formato JSON detalhando o resultado da verificação da autorização, incluindo checklist, normalizações, valores calculados e pendências.
-
Exemplo de Estrutura de Output:
{ "autorizacao_verificada": true|false, "checklist": { "identificacao_beneficiario_valida": true|false, "elegibilidade_vigente": true|false, "plano_cobre_procedimento": true|false, "carencia_cumprida": true|false, "dut_atendida": true|false, "limites_quantitativos_ok": true|false, "documentacao_obrigatoria_ok": true|false, "prestador_credenciado_ok": true|false, "cid_compativel": true|false, "integridade_documental_ok": true|false }, "itens_analisados": [ { "codigo_tuss": "string", "quantidade_solicitada": number, "quantidade_aprovavel": number, "motivos_restricao": ["string"] } ], "normalizacoes": { "tuss_normalizados": true, "cid10_normalizados": true }, "valores_calculados": { "coparticipacao_percentual": number|null, "coparticipacao_valor_estimado": number|null }, "pendencias": ["string"], "referencias_utilizadas": [{"topico": "string", "referencia": "url|id_doc"}], "observacoes": "string" } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 2.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 documentos externos.
- Calculadora: Utiliza lógica interna para cálculo de coparticipações e valores estimados.
- Busca Online: Não utiliza.
- Sistemas Externos: Não se conecta a sistemas externos.
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 deve ser visível para o Agente de Decisão de Aprovação de Autorizações (RF 5).
4.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Decisão de Aprovação de Autorizações (RF 5).
RF 5. Agente de Decisão de Aprovação de Autorizações
5.1 Tarefa do Agente
Emitir decisão automatizada (aprovação, aprovação parcial, pendência ou negativa) com fundamentação objetiva.
5.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo o resultado estruturado do Agente de Verificação de Autorizações. Este resultado contém informações detalhadas sobre a conformidade da autorização com as políticas aplicáveis.
# 2. Objetivo
Emitir uma decisão automatizada sobre a autorização, fundamentando-a com base nos dados verificados e nas políticas aplicáveis.
# 3. Regras que você deve seguir para gerar sua resposta
- Aprove integralmente quando autorizacao_verificada = true e não houver pendências.
- Aprove parcialmente quando houver restrição de quantidade ou limite, fundamentando a decisão.
- Classifique como pendente se faltar documentação obrigatória ou evidência para cumprir DUT/carência.
- Negue quando houver exclusão explícita de cobertura no produto ou não atendimento de DUT.
- Defina prazo de validade da autorização conforme o tipo de atendimento e as regras específicas encontradas.
- Preencha coparticipação com os valores calculados se disponíveis.
- Marque prioridade como urgente se o documento indicar urgência/emergência.
# 4. Exemplo de Output que você deve produzir
{
"decisao": "aprovada|aprovada_parcial|pendente|negada",
"itens_decididos": [
{
"codigo_tuss": "string",
"quantidade_solicitada": number,
"quantidade_aprovada": number
}
],
"fundamentos": ["string"],
"exigencias": ["string"],
"prazo_validade_autorizacao_dias": number,
"classe_prioridade": "urgente|eletivo",
"coparticipacao": {
"percentual": number|null,
"valor_estimado": number|null
}
} 5.3 Configurações do Agente
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).
- Tipo do input: Este agente deve ser apto a receber como input o resultado estruturado do Agente de Verificação de Autorizações.
-
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é 4.000 caracteres.
5.3.2 Especificação do Output
- Formato de output: O output deve ser um arquivo no formato JSON detalhando a decisão automatizada sobre a autorização, incluindo itens decididos, fundamentos, exigências e coparticipação.
-
Exemplo de Estrutura de Output:
{ "decisao": "aprovada|aprovada_parcial|pendente|negada", "itens_decididos": [ { "codigo_tuss": "string", "quantidade_solicitada": number, "quantidade_aprovada": number } ], "fundamentos": ["string"], "exigencias": ["string"], "prazo_validade_autorizacao_dias": number, "classe_prioridade": "urgente|eletivo", "coparticipacao": { "percentual": number|null, "valor_estimado": number|null } } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.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 documentos externos.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Não se conecta a sistemas externos.
5.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 - Atualização de Status (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 - Atualização de Status (RF 6).
RF 6. Agente de Execução de Chamada à API - Atualização de Status
6.1 Tarefa do Agente
Realizar chamada à API do sistema da administradora para registrar o status e a decisão da autorização.
6.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um payload pronto com identificadores, decisão, itens decididos, fundamentos e prazos. Este payload é essencial para registrar o status e a decisão da autorização no sistema da administradora.
# 2. Objetivo
Realizar a chamada à API do sistema da administradora para registrar o status e a decisão da autorização, garantindo que todas as informações sejam atualizadas corretamente.
# 3. Regras que você deve seguir para gerar sua resposta
- Utilize os identificadores e dados fornecidos para compor a chamada à API.
- Garanta que o status e a decisão sejam registrados corretamente no sistema.
- Registre o resultado da chamada, incluindo protocolo e mensagem de sucesso ou falha.
# 4. Exemplo de Output que você deve produzir
{
"status_atualizacao": "sucesso|falha",
"protocolo": "string|null",
"mensagem": "string"
} 6.3 Configurações do Agente
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).
- Tipo do input: Este agente deve ser apto a receber como input um JSON contendo o payload pronto para a chamada à API.
-
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é 2.000 caracteres.
6.3.2 Especificação do Output
- Formato de output: O output deve ser um arquivo no formato JSON detalhando o resultado da chamada à API, incluindo status de atualização, protocolo e mensagem.
-
Exemplo de Estrutura de Output:
{ "status_atualizacao": "sucesso|falha", "protocolo": "string|null", "mensagem": "string" } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 500 caracteres.
6.3.3 Parâmetros de Geração
- Modelo: Não se aplica (uso de ferramenta)
- Temperatura: Não se aplica
6.3.4 Ferramentas do Agente
- Documentos: Não consulta documentos externos.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: O agente deverá enviar o JSON recebido para a API externa do sistema da administradora e retornar o resultado da chamada.
6.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 - Notificações (RF 7).
6.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 - Notificações (RF 7).
RF 7. Agente de Execução de Chamada à API - Notificações
7.1 Tarefa do Agente
Disparar notificações para beneficiário e prestador com o resultado da autorização, via canais configurados.
7.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um payload pronto contendo canais, destinatários, mensagem formatada com decisão, itens, exigências e prazo. Este payload é essencial para informar as partes envolvidas sobre o resultado da autorização.
# 2. Objetivo
Disparar notificações para o beneficiário e prestador com o resultado da autorização, garantindo que todas as informações sejam comunicadas de forma clara e eficaz.
# 3. Regras que você deve seguir para gerar sua resposta
- Utilize os canais configurados para enviar as notificações, garantindo que a mensagem seja recebida por todos os destinatários.
- Registre o resultado de cada notificação, incluindo status de envio e protocolo de envio.
# 4. Exemplo de Output que você deve produzir
{
"notificacoes_enviadas": [
{
"destinatario": "string",
"canal": "email|sms|app",
"status": "sucesso|falha",
"protocolo_envio": "string|null"
}
]
} 7.3 Configurações do Agente
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 como input um JSON contendo o payload pronto para disparo de notificações.
-
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é 2.000 caracteres.
7.3.2 Especificação do Output
- Formato de output: O output deve ser um arquivo no formato JSON detalhando o resultado do envio das notificações, incluindo destinatários, canais, status e protocolos de envio.
-
Exemplo de Estrutura de Output:
{ "notificacoes_enviadas": [ { "destinatario": "string", "canal": "email|sms|app", "status": "sucesso|falha", "protocolo_envio": "string|null" } ] } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 500 caracteres.
7.3.3 Parâmetros de Geração
- Modelo: Não se aplica (uso de ferramenta)
- Temperatura: Não se aplica
7.3.4 Ferramentas do Agente
- Documentos: Não consulta documentos externos.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: O agente deverá enviar o JSON recebido para o sistema de notificações configurado e registrar o resultado do envio.
7.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 (resultado das notificações) é o entregável final e não é passada para outros agentes internos.
7.3.6 Regras de Orquestração e Transição
A execução deste agente finaliza o fluxo. O resultado das notificações deve ser disponibilizado para a equipe responsável pelo acompanhamento.