Homologação

Assistente Virtual do CTIC

Esta página reúne as informações necessárias para validação da inclusão do Assistente Virtual do CTIC no Sagitta.

O widget já está publicado em HTTPS no domínio institucional assistente.ctic.ufpa.br e utiliza API própria no mesmo domínio.

Objetivo

O Assistente Virtual do CTIC tem como objetivo orientar usuários com base na documentação dos serviços de TIC da UFPA.

Nesta versão piloto, a base inicial está restrita a assuntos relacionados a sites institucionais: hospedagem, FTP, VPN para FTP, certificado SSL, domínios, redirecionamentos, credenciais, área administrativa de Joomla/WordPress e limites de suporte do CTIC.

Código de embed recomendado

Inserir preferencialmente no layout global do Sagitta, antes do fechamento da tag </body>.

<script src="https://assistente.ctic.ufpa.br/kodama/widget.js"></script>

Endpoints utilizados

Widget:
https://assistente.ctic.ufpa.br/kodama/widget.js

API:
https://assistente.ctic.ufpa.br/kodama/api/chat.php

Página de teste:
https://assistente.ctic.ufpa.br/teste-widget.html

Requisitos de CSP, se aplicável

Caso o Sagitta utilize Content Security Policy restritiva, pode ser necessário permitir o domínio do assistente nas diretivas de script e conexão.

script-src https://assistente.ctic.ufpa.br
connect-src https://assistente.ctic.ufpa.br

Se a opção de integração escolhida futuramente for via iframe, também será necessário:

frame-src https://assistente.ctic.ufpa.br

Segurança e comportamento

O widget é carregado por HTTPS.
As respostas são geradas com base na documentação local do CTIC.
O assistente não deve inventar portas, IPs, hosts, senhas, comandos ou caminhos internos.
Perguntas fora da base atual não chamam a OpenAI e não consomem a cota mensal.
Há limite interno de uso mensal para controle de custo.
A chave da OpenAI não fica publicada no diretório web.

Teste visual

A página de teste pode ser acessada em:
https://assistente.ctic.ufpa.br/teste-widget.html

Observação sobre o nome interno

O nome interno do projeto é Kodama, mas para o usuário final a identificação pública utilizada no widget é Assistente Virtual do CTIC.

Observação: esta é uma versão piloto. A inclusão no Sagitta deve ser validada pelo setor responsável pelo sistema, especialmente quanto a layout, CSP e política de carregamento de scripts externos.