Como Criar um Novo Assistente

Este guia descreve o fluxo completo para criar um assistente na Plataforma Admin, seja ele com recuperação aumentada por conhecimento (RAG) ou somente conversacional.

Visão Geral

Ao criar um assistente você define:

1. Informações básicas (nome, descrição, provedor/modelo)
2. Prompts e parâmetros de sistema, usuário e resposta
3. Modo de funcionamento: com ou sem RAG
4. Coleções de conhecimento (quando RAG estiver habilitado)
5. Ferramentas MCP e workflows opcionais

Pré-requisitos

• Ter pelo menos um provedor/modelo configurado
• Ter Coleções de Conhecimento prontas, caso deseje usar RAG
• Permissão de acesso de nível CURADOR ou superior ao projeto em que o assistente será criado

Passo 1: Acessar a Página de Criação

1. Faça login na plataforma admin.
2. No menu lateral principal, selecione Projetos e escolha o projeto desejado.
3. Clique em Assistentes no menu lateral do projeto.
4. Pressione o botão + Nova IA no canto superior direito.

Passo 2: Seleção de IA

Ao clicar em + Nova IA, você será direcionado para o fluxo de criação. A primeira etapa é selecionar o tipo de IA que deseja criar.

1. Na tela "Nova IA", você verá a opção Assistente disponível
2. Clique no card "Assistente" para criar um assistente de IA personalizado
3. Clique em Próximo para continuar

Passo 3: Detalhes do Assistente

Na segunda etapa, você configurará as informações básicas do assistente:

Preencha os seguintes campos:

• Nome (obrigatório): Um nome descritivo para identificar o assistente
• Tipo de assistente (obrigatório): Escolha entre:
  • Com RAG: Para assistentes que utilizam recuperação aumentada por conhecimento
  • Sem RAG: Para assistentes conversacionais sem acesso a coleções de conhecimento
• Descrição: Uma descrição opcional sobre o propósito e funcionalidades do assistente

Após preencher, clique em Próximo para continuar.

Passo 4: Seleção do Modelo

Na terceira etapa, você selecionará o modelo de IA que será utilizado pelo assistente.

1. Revise os modelos disponíveis na lista
2. Clique no modelo desejado (por exemplo, "GPT-4o")
3. Selecione a versão específica do modelo no dropdown "Selecione a versão"
4. Você pode clicar no ícone de informações (ⓘ) para ver detalhes do modelo, incluindo:
   • Limites de tokens (input e output)
   • Custos por token
   • Capacidades (Function Calling, Vision, etc.)
   • Versões disponíveis

Após selecionar o modelo e a versão, clique em Próximo para continuar.

Passo 5: Escolher o Modo (Sem RAG x Com RAG)

Assistente Sem RAG

• Ideal para fluxos em que todo o contexto está no prompt ou em ferramentas MCP.
• Apenas confirme os prompts e parâmetros; nenhuma fonte de conhecimento é carregada.

Assistente com RAG

1. Se você selecionou "Com RAG" na etapa anterior, esta etapa permitirá selecionar as coleções de conhecimento.

2. Selecione Coleções de Conhecimento: Clique nos cards das coleções que deseja utilizar. As coleções selecionadas aparecerão destacadas em azul.
3. Você pode selecionar múltiplas coleções para combinar diferentes fontes de conhecimento.
4. Configure número de documentos recuperados. Esse é o número total de trechos que serão fornecidos à IA para ela gerar a resposta. Números mais altos (>10) trazem mais contexto, mas podem confundir a IA. O valor ótimo depende da aplicação e deve ser experimentado.
5. Ajuste campos específicos como tamanho de contexto, temperatura de busca (controla a criatividade das respostas) e limites de tokens (quantidade máxima de texto que pode ser processado).

Para criar coleções ou fontes, consulte a Introdução a Coleções de Conhecimento e a Introdução a Fonte de Conhecimento.

Passo 6: Seleção de Servidores MCP

Você pode habilitar integrações MCP para permitir que o assistente execute ações externas (consultar APIs, disparar automações, etc.).

Para selecionar servidores MCP, você precisa primeiro instalá-los na seção Servidores MCP do projeto. Acesse essa seção através do menu lateral do projeto.

Na tela de Servidores MCP, você pode:

• Visualizar servidores Instalados
• Buscar e instalar servidores do Docker Hub
• Buscar e instalar servidores do GitHub

Para instalar um servidor do Docker Hub:

1. Clique na aba Docker Hub
2. Use a barra de busca para encontrar o servidor desejado
3. Clique no card do servidor para ver os detalhes
4. Revise as informações do servidor, incluindo:
   • Descrição do servidor
   • Autor e imagem Docker
   • Comando necessário
   • Variáveis de ambiente requeridas
5. Configure as variáveis de ambiente necessárias (por exemplo, BRAVE_API_KEY para o servidor Brave Search)
6. Clique em Instalar

Após instalar os servidores MCP, você poderá selecioná-los na etapa de criação do assistente:

1. Configure o Máximo de Iterações de ferramentas: Defina quantas vezes as ferramentas podem ser executadas em sequência (exemplo: 5). Valores mais altos dão mais liberdade para a IA, mas podem fazer com que ela entre em um loop de erro para problemas mais complexos.
2. Selecione os servidores MCP: Clique nos servidores MCP que deseja habilitar (máximo de 5 servidores)
3. Os servidores selecionados aparecerão destacados em azul
4. Exemplos de servidores disponíveis: "bible", "youtube_transcript", "playwright", etc.

Após configurar, clique em Próximo para continuar.

Passo 7: Detalhes do Workflow

Na etapa final, você configurará os detalhes do workflow e os prompts do assistente.

Configure as seguintes opções:

1. Número de Fragmentos Recuperados: Defina quantos fragmentos de documentos serão recuperados para o contexto (exemplo: 5)
2. Buscar documentos completos: Marque esta opção se desejar recuperar documentos completos em vez de apenas fragmentos
3. Edite seus prompts:
   • Reescrever Pergunta: Prompt que reformula a pergunta do usuário de forma independente do contexto da conversa
   • Responder ao Usuário: Prompt que orienta como o assistente deve responder com base no contexto fornecido

Após revisar todas as configurações, clique em Salvar para criar o assistente.

Passo 8: Confirmação

Após clicar em Salvar, você verá uma notificação de sucesso confirmando que o assistente foi criado.

O assistente ficará disponível imediatamente na listagem de assistentes e já poderá ser utilizado nas conversas.

Próximos Passos

• Gerenciar Assistentes
• Configurar Coleções de Conhecimento
• Conectar Fontes de Conhecimento