Como criar Agentes?

Aceder à plataforma e criar novo agente:

• Aceda à plataforma IAedu através do seu navegador.
• Inicie sessão com as suas credenciais.
• No painel principal, procure a opção "Criar agente" encontra-se no canto superior direito.
• Clique em "Criar Agente".

Nomear e Descrever o Agente:

Esta é etapa inicial que define a identidade do seu agente.  Ao criar um novo agente, será necessário atribuir:

Nome do agente

O nome deve ser:

• Claro
• Objetivo
• Representativo da função do agente

  Exemplo:

  • "Assistente de Apoio ao Aluno"
  • "Tutor de Matemática"

Descrição do agente

A descrição deve explicar:

• O propósito do agente
• O tipo de tarefas que irá executar
  

Escrever a system prompt (com boas práticas e exemplos):

A system prompt é um dos elementos mais importantes na criação de um agente, pois define o seu comportamento, tom e limitações.

Boas práticas

• Seja específico
• Defina o papel do agente
• Indique o público-alvo
• Estabeleça o tom de comunicação (formal, informal, pedagógico, etc.)
• Inclua instruções sobre como responder (ex.: passo a passo, exemplos, simplificação de conceitos)
• Evite ambiguidades
  

Estrutura recomendada

Uma boa system prompt deve incluir:

1. Identidade do agente
2. Objetivo
3. Regras de comportamento
4. Estilo de comunicação
5. Restrições (se aplicável)

Exemplo de uma system prompt

Prompt
1. Objetivo Claro
Especifique qual é a função do modelo: responder perguntas, gerar código, resumir textos, atuar como tutor.
Defina o nível de profundidade esperado (ex.: básico, avançado, pós-graduado).
Exemplo:
"Você é um assistente especializado em física teórica, matemático e cientista da computação, capaz de explicar conceitos complexos de forma rigorosa e detalhada."

2. Estilo e Tom
Determine o registro linguístico: formal, informal, técnico, didático.
Oriente sobre uso de linguagem inclusiva, neutra e clara.
Exemplo:
"Use linguagem formal, evite simplificações excessivas, e seja inclusivo e preciso."

3. Formato e Estrutura da Resposta
Defina se o modelo deve usar listas, seções, LaTeX, JSON ou outros formatos.
Indique se deve resumir ou detalhar passo a passo.
Exemplo:
"Forneça respostas estruturadas em tópicos, inclua fórmulas em LaTeX e destaque conclusões importantes."

4. Nível de Rigor e Verificação
Especifique quão rigorosa deve ser a resposta: baseada em fatos, evidências ou especulações explícitas.
Oriente sobre verificação cruzada e consistência lógica.
Exemplo:
"Todas as afirmações devem ser baseadas em fontes confiáveis; inclua consistência com definições e teoremas reconhecidos."

5. Comentários sobre Restrições ou Ética
Informe limitações quanto a temas sensíveis, preconceituosos ou perigosos.
Defina diretrizes para recusar pedidos inadequados de forma educada.
Exemplo:
"Não forneça instruções ilegais, perigosas ou conteúdo ofensivo; recuse de forma clara quando necessário."

6. Parâmetros de Criatividade
Controle a criatividade do modelo (ex.: conservador, equilibrado, exploratório).
Oriente sobre geração de hipóteses ou exemplos ilustrativos.
Exemplo:
"Se apropriado, forneça analogias, exemplos numéricos e modelos mentais, mantendo o rigor científico."

7. Gestão de Instruções Implícitas
Clarifique se o modelo deve assumir premissas implícitas no contexto ou questionar suposições.
Indique o nível de detalhamento em contraexemplos ou análises contraintuitivas.
Exemplo:
"Questione premissas não explícitas e explore cenários de borda para validação de hipóteses."

Depois de criar uma boa system prompt é só inserir dentro deste espaço:

Uma system prompt bem construída melhora significativamente a qualidade das respostas do agente.
Para mais informações, poderá aceder à página: O que é uma System Prompt?

Escolher um dos Modelos sugeridos:

A escolha do modelo é uma etapa crítica que deve ser feita com muita atenção.

Diferentes modelos apresentam características distintas

A utilização de modelos em versões mais recentes contribui igualmente para a melhoria da qualidade das respostas do agente, bem como para o aumento da sua capacidade de execução das instruções.

Para além dos agentes que pode criar autonomamente, a plataforma IAedu disponibiliza também os modelos destinados ao apoio de múltiplas tarefas.

Para mais informações, poderá aceder à página: O que é um Modelo?

Carregar ficheiros para a base de conhecimento:

A plataforma IAedu permite enriquecer o agente com uma base de conhecimento personalizada.

Tipos de ficheiros

Pode carregar:

• PDFs
• Documentos de texto
• Materiais pedagógicos
• Guias internos

Boas práticas

• Utilize conteúdos relevantes e atualizados
• Organize a informação de forma clara
• Evite ficheiros demasiado extensos ou desorganizados

  

Benefícios

• Respostas mais precisas
• Contexto mais rico
• Maior utilidade prática do agente

Caso não pretenda utilizar determinadas fontes da base de conhecimento do agente, basta clicar no ícone assinalado (com a imagem de confirmação) para que o agente deixe de recorrer a essa fonte como apoio.

Testar o agente com perguntas reais

Após configurar o agente, é essencial testá-lo.

Como testar

• Faça perguntas reais que os utilizadores fariam
• Experimente diferentes níveis de dificuldade
• Teste cenários variados

O que avaliar

• Clareza das respostas
• Correção da informação
• Adequação ao público-alvo
• Consistência no comportamento

Exemplo:

Ao adicionar um documento à base de conhecimento, como no exemplo acima referido, é possível testar o agente através da colocação de questões sobre o respetivo tema.

Iteração

Caso identifique problemas:

• Ajuste a system prompt
  
• Atualize a base de conhecimento
• Alterar Modelo

O processo de teste e melhoria é contínuo e essencial para garantir a qualidade do agente.