#Funcionário IA · Guia de Configuração do Administrador

Este documento ajuda você a entender rapidamente como configurar e gerenciar funcionários IA, guiando você passo a passo por todo o processo, desde o serviço de modelo até a entrada em serviço das tarefas.

#I. Antes de Começar

#1. Requisitos do Sistema

Antes de configurar, certifique-se de que seu ambiente atende às seguintes condições:

• NocoBase 2.0 ou superior instalado
• Plugin de Funcionário IA habilitado
• Pelo menos um serviço de modelo de linguagem grande (LLM) disponível (como OpenAI, Claude, DeepSeek, GLM, etc.)

#2. Entenda o Design de Duas Camadas do Funcionário IA

Os funcionários IA são divididos em duas camadas: "Definição de Papel" e "Customização de Tarefa".

Entendimento simples:

"Definição de Papel" determina quem é este funcionário, "Customização de Tarefa" determina o que ele deve fazer no momento.

As vantagens deste design são:

• O papel não muda, mas ele pode ser competente em diferentes cenários
• Atualizar ou substituir tarefas não afeta o funcionário em si
• O contexto e as tarefas são independentes, facilitando a manutenção

#II. Processo de Configuração (5 passos)

#Passo 1: Configurar o Serviço de Modelo

O serviço de modelo equivale ao cérebro do funcionário IA e deve ser configurado primeiro.

💡 Para instruções detalhadas de configuração, consulte: Configurar serviço LLM

Caminho: Configurações do sistema → Funcionário IA → LLM service

Clique em Adicionar e preencha as seguintes informações:

Após a configuração, use o Test flight para testar a conexão. Se falhar, verifique a rede, a chave ou o nome do modelo.

#Passo 2: Criar Funcionário IA

💡 Para instruções detalhadas, consulte: Criar Funcionário IA

Caminho: Gerenciamento de Funcionários IA → Criar funcionário

Preencha as informações básicas:

A fase de criação do funcionário conclui principalmente a configuração de papel e habilidades. O modelo real utilizado pode ser selecionado no chat através do Model Switcher.

Sugestões para escrita de prompts:

• Deixe claro o papel, o tom e as responsabilidades do funcionário
• Use palavras como "deve" e "nunca" para enfatizar regras
• Tente incluir exemplos para evitar instruções abstratas
• Controle entre 500 e 1000 caracteres

Quanto mais claro o prompt, mais estável será o desempenho da IA. Você pode consultar o Guia de Engenharia de Prompt.

#Passo 3: Configurar Habilidades

As habilidades determinam o que o funcionário "pode fazer".

💡 Para instruções detalhadas, consulte: Habilidades

Sugestões de configuração:

• 3 a 5 habilidades por funcionário é o mais adequado
• Não é recomendado selecionar tudo, para evitar confusão
• Para operações importantes, sugere-se usar a permissão Ask em vez de Allow

#Passo 4: Configurar Base de Conhecimento (Opcional)

Se o seu funcionário IA precisar memorizar ou referenciar uma grande quantidade de materiais, como manuais de produtos, FAQs, etc., você pode configurar uma base de conhecimento.

💡 Para instruções detalhadas, consulte:

• Visão Geral da Base de Conhecimento de IA
• Banco de Dados Vetorial
• Configuração da Base de Conhecimento
• RAG (Geração Aumentada por Recuperação)

Isso requer a instalação adicional do plugin de banco de dados vetorial.

Cenários aplicáveis:

• Fazer a IA entender o conhecimento da empresa
• Suportar perguntas, respostas e recuperação de documentos
• Treinar assistentes exclusivos de um domínio

#Passo 5: Verificar o Efeito

Após concluir, você verá o avatar do novo funcionário no canto inferior direito da página.

Verifique item por item:

• ✅ O ícone é exibido normalmente?
• ✅ É possível realizar um diálogo básico?
• ✅ As habilidades podem ser chamadas corretamente?

Se tudo passar, a configuração foi bem-sucedida 🎉

#III. Configuração de Tarefas: Fazendo a IA Trabalhar de Fato

O que foi feito anteriormente foi a "criação do funcionário", agora é necessário fazê-los "ir trabalhar".

As tarefas de IA definem o comportamento do funcionário em uma página ou bloco específico.

💡 Para instruções detalhadas, consulte: Tarefas

#1. Tarefas de Nível de Página

Aplicáveis ao escopo de toda a página, como "Analisar os dados desta página".

Entrada de configuração: Configurações da página → Funcionário IA → Adicionar tarefa

Suporte a múltiplas tarefas: Um mesmo funcionário IA pode ter várias tarefas configuradas, oferecidas como opções para o usuário:

Sugestões:

• Uma tarefa deve focar em um objetivo
• O nome deve ser claro e fácil de entender
• Controle o número de tarefas entre 5 e 7

#2. Tarefas de Nível de Bloco

Adequadas para operar em um bloco específico, como "Traduzir o formulário atual".

Método de configuração:

1. Abra a configuração de operações do bloco
2. Adicione "Funcionário IA"

3. Vincule ao funcionário desejado

#IV. Melhores Práticas

#1. Sugestões de Configuração

#2. Sugestões Práticas

Do pequeno ao grande, otimize gradualmente:

1. Crie primeiro funcionários básicos (como Viz, Dex)
2. Habilite 1 ou 2 habilidades centrais para teste
3. Confirme se as tarefas podem ser executadas normalmente
4. Então, expanda gradualmente para mais habilidades e tarefas

Processo de otimização contínua:

1. Faça a primeira versão rodar
2. Colete feedback de uso
3. Otimize prompts e configurações de tarefas
4. Teste e melhore em ciclos

#V. Perguntas Frequentes

#1. Fase de Configuração

P: O que fazer se a gravação falhar? R: Verifique se todos os campos obrigatórios foram preenchidos, especialmente o serviço de modelo e o prompt.

P: Qual modelo escolher?

• Programação → Claude, GPT-4
• Análise → Claude, DeepSeek
• Sensível a custo → Qwen, GLM
• Texto longo → Gemini, Claude

#2. Fase de Uso

P: A resposta da IA está muito lenta?

• Reduza o número de habilidades
• Otimize o prompt
• Verifique a latência do serviço de modelo
• Considere trocar de modelo

P: A execução da tarefa não é precisa?

• O prompt não está claro o suficiente
• Excesso de habilidades causando confusão
• Divida em tarefas menores, adicione exemplos

P: Quando escolher Ask ou Allow?

• Tarefas de consulta podem usar Allow
• Tarefas de modificação de dados sugerem o uso de Ask

P: Como fazer a IA processar um formulário específico?

R: Se for uma configuração de nível de página, é necessário selecionar o bloco manualmente.

Se for uma configuração de tarefa de nível de bloco, o contexto de dados é vinculado automaticamente.

#VI. Leitura Adicional

Para tornar seu funcionário IA mais poderoso, continue lendo os seguintes documentos:

Relacionados à Configuração:

• Guia de Engenharia de Prompt - Técnicas e melhores práticas para escrever prompts de alta qualidade
• Configurar serviço LLM - Instruções detalhadas de configuração para serviços de modelos grandes
• Criar Funcionário IA - Criação e configuração básica de funcionários IA
• Colaborar com Funcionário IA - Como realizar diálogos eficazes com funcionários IA

Recursos Avançados:

• Habilidades - Entenda profundamente a configuração e o uso de diversos tipos de habilidades
• Tarefas - Técnicas avançadas de configuração de tarefas
• Selecionar Bloco - Como designar blocos de dados para funcionários IA
• Fonte de dados - Consulte o documento de configuração de fonte de dados do plugin correspondente
• Pesquisa na Rede - Configure a capacidade de pesquisa na rede para funcionários IA

Base de Conhecimento e RAG:

• Visão Geral da Base de Conhecimento de IA - Introdução às funções da base de conhecimento
• Banco de Dados Vetorial - Configuração de bancos de dados vetoriais
• Base de Conhecimento - Como criar e gerenciar bases de conhecimento
• RAG (Geração Aumentada por Recuperação) - Aplicação da tecnologia RAG

Integração com Fluxo de Trabalho:

• Nó LLM - Diálogo de Texto - Use diálogos de texto em fluxos de trabalho
• Nó LLM - Diálogo Multimodal - Processe entradas multimodais como imagens e arquivos
• Nó LLM - Saída Estruturada - Obtenha respostas de IA estruturadas

#结语 (Conclusão)

O mais importante ao configurar funcionários IA é: faça rodar primeiro, depois otimize. Deixe o primeiro funcionário entrar em serviço com sucesso e, então, expanda e ajuste gradualmente.

A ordem de resolução de problemas pode seguir esta sequência:

1. O serviço de modelo está conectado?
2. O número de habilidades é excessivo?
3. O prompt está claro?
4. O objetivo da tarefa está definido?

Seguindo passo a passo, você poderá construir uma equipe de IA verdadeiramente eficiente.