Primeiros passos

Integrar com o agente Dr. JON é simples e rápido. Siga o passo a passo e ao final desse módulo de primeiros passos, você já será capaz de utilizar vários recursos da nossa Inteligência Artificial.

Configurações Básicas

Para realizar as chamadas é necessário utilizar a sua chave de API no header da requisição. Sua chave é intransferível e deve ser protegida contra vazamentos e exposição pública. As chaves são recebidas por nosso email oficial.

API_KEY

i{exemplo}

Atenção

Essas chaves são fictícias e não devem ser usadas nas requisições. As chaves reais de integrações são recebidas através do email de boas-vindas de integração

URLs Dr. JON (Ambiente de testes)

API_URL

Essa url abaixo é utilizada para fazer as requisições do tipo HTTP REST para o back-end do Dr. JON.

BASE_URL

https://integrations.drjon.com.br/

---

Endpoints

As chamadas para o Dr. JON são baseadas na ideia de um contexto textual inicial para o agente e uma solicitação específica para cada retorno esperado. Existem boas práticas de prompt para as chamadas que você pode explorar com mais detalhes na seção de API Reference.

Receber hipóteses diagnósticas

A partir do texto do prontuário você pode solicitar hipóteses diagnósticas para o Dr. JON que serão avaliadas de acordo com as informações fornecidas na requisição.

Veja Hipóteses Diagnósticas para mais detalhes de implementação.

Request

Method: POST

Endpoint: '{base_url}/diagnostics'

// POST /diagnostics?streaming=false
Headers: {
    "X-API-Key": {API_KEY},
    "Content-Type": "application/json",
},
query: {
    streaming: true || false
}
body: {
    "prompt": "Texto do prontuário completo",
}

Response

// Response POST /diagnostics

{
    "status_code": 200,
    "content": "Resposta do agente"
}

Atenção

A função STREAMING passada na query determina a natureza da resposta do agente. Quando Streaming estiver setado como true o front-end deve ser adaptado para fazer o display da resposta com o efeito de "typing", funcionalidade comum em aplicações de IA hoje.

Se preferir receber apenas a resposta completa de uma só vez você pode deixar streaming desabilitado.

Receber sugestões de conduta

A partir do texto do prontuário você pode solicitar sugestões de conduta para o Dr. JON que serão avaliadas de acordo com as informações fornecidas na requisição.

Veja Condutas para mais detalhes de implementação.

Request

Method: POST

Endpoint: '{base_url}/procedure'

// POST /procedure?streaming=false
Headers: {
    "X-API-Key": {API_KEY},
    "Content-Type": "application/json",
},
query: {
    streaming: true || false
}
body: {
    "prompt": "Texto do prontuário completo",
}

Response

// Response POST /procedure

{
    "status_code": 200,
    "content": "Resposta do agente"
}

Atenção

A função STREAMING passada na query determina a natureza da resposta do agente. Quando Streaming estiver setado como true o front-end deve ser adaptado para fazer o display da resposta com o efeito de "typing", funcionalidade comum em aplicações de IA hoje.

Se preferir receber apenas a resposta completa de uma só vez você pode deixar streaming desabilitado.

Perguntas gerais e pesquisa

O Dr. JON também pode atuar como um agente de pesquisa e Q&A. O usuário pode fazer desde perguntas simples como:

"Quais as causas mais comuns da arritmia cardíaca?"

Até perguntas mais complexas:

"Maria Eduarda relata que vem apresentando fome e cansaço excessivos, aumento do volume da urina(poliúria), muita sede (polidpsia) e mudanças bruscas de humor. Além disso, sua glicose apresentou alteração. Qual a principal hipótese diagnóstica?"

O módulo de perguntas do Dr. JON realiza inúmeras atividades, inclusive as atividades das requisições acima. O detalhe importante, porém, é que a pergunta esteja bem definida no prompt para que o agente retorne bons resultados.

Veja Perguntas para mais detalhes de implementação e boas práticas.

Request

Method: POST

Endpoint: '{base_url}/askDoctor'

// POST /askDoctor?streaming=false
Headers: {
    "X-API-Key": {API_KEY},
    "Content-Type": "application/json",
},
query: {
    streaming: true || false
}
body: {
    "prompt": "Texto do prontuário completo",
}

Response

// Response POST /procedure

{
    "status_code": 200,
    "content": "Resposta do agente"
}

Atenção

A função STREAMING passada na query determina a natureza da resposta do agente. Quando Streaming estiver setado como true o front-end deve ser adaptado para fazer o display da resposta com o efeito de "typing", funcionalidade comum em aplicações de IA hoje.

Se preferir receber apenas a resposta completa de uma só vez você pode deixar streaming d