📖 Primeiros Passos · Capítulo 01

5 Conceitos Fundamentais de IA

Antes de utilizar o EasyClaw, dedique 5 minutos a compreender estes conceitos — ajudá-lo-ão a entender verdadeiramente como a IA funciona, em vez de inserir comandos às cegas.

1. Agente (Entidade Inteligente)

🗣️

Compreensão Comum

A IA é o seu assistente digital ou chatbot.

🧠

Compreensão Profunda

A IA normal responde diretamente às perguntas; um Agente planeia, utiliza ferramentas e verifica resultados antes de responder — como um colega verdadeiramente capaz.

Por exemplo: quando diz "ajuda-me a organizar a minha caixa de entrada", a IA normal apenas diz-lhe como fazer; o Agente do EasyClaw abre diretamente o cliente de email → classifica e arquiva → responde a emails importantes → reporta o estado de conclusão.

2. Skills (Capacidades)

🗣️

Compreensão Comum

As capacidades de IA são várias ferramentas ou aplicações avançadas.

🧩

Compreensão Profunda

As Skills são manuais de operação profissional empacotados. Após a instalação, o Agente sabe como chamar corretamente a API do Lark, gerar imagens, reconhecer matrículas... em vez de adivinhar.

Pense numa Skill como "instruções para a IA": com ela, a IA domina as especificações completas de operação de um determinado domínio. Mercado de Skills: clawhub.com

💡
Como funcionam as Skills?
Quando envia uma tarefa, o Agente analisa as descrições de todas as Skills instaladas, carrega as especificações de operação correspondentes após correspondência, e guia cada passo subsequente da execução.

3. Prompt (Instruções)

🗣️

Compreensão Comum

É um "pedido de uma frase" que diz à IA em linguagem natural.

🎯

Compreensão Profunda

O Prompt é a interface principal para comunicar com a IA. Um bom Prompt inclui: definição de papel, informação de contexto, requisitos específicos de passos e formato de saída.

TipoExemploEfeito
❌ Prompt Normal"Ajuda-me a escrever um email"A IA só pode adivinhar, qualidade de saída fraca
✅ Bom Prompt"És um vendedor B2B, ajuda-me a escrever um email de acompanhamento de produto para um CTO, tom profissional e conciso, terminando com uma próxima ação clara"Papel + contexto + formato, saída precisa

4. Memória / MEMORY.md

🗣️

Compreensão Comum

O "bloco de notas" da IA.

🗄️

Compreensão Profunda

A Memória é o núcleo da memória de longo prazo do Agente. As conversas normais são eliminadas após terminar; mas o conteúdo escrito no MEMORY.md será priorizado pelo Agente em cada arranque — memoriza permanentemente as suas preferências e SOPs de trabalho.

Por exemplo, se disser ao Agente "prefiro respostas concisas em inglês, código em Python", após este registo entrar no MEMORY.md, o Agente seguirá automaticamente sempre, sem necessidade de repetir.

Conselho Prático
Diga os seus hábitos de trabalho, requisitos de formato comuns, contactos importantes, etc. ao Agente "uma vez" — deixe-o escrever na memória, e o seu assistente de IA compreendê-lo-á melhor ao longo do tempo.

5. Soul / SOUL.md

🗣️

Compreensão Comum

As "definições de personalidade" da IA.

Compreensão Profunda

O SOUL.md define as regras de comportamento, valores e limites operacionais do Agente. É a constituição fundamental do Agente — o que pode ser feito, o que absolutamente não pode ser feito, tudo escrito aqui.

Se a Memória é "o que lembrar", então a Soul é "as regras de quem se tornar". Por exemplo: responder apenas a perguntas relacionadas com produtos, operações financeiras devem ser duplamente confirmadas, proibir pedir palavras-passe...

⚠️
Nota para Utilizadores Avançados
As definições do SOUL.md afetam diretamente os limites de segurança do Agente. Se planeia implementar o EasyClaw como ferramenta de equipa, certifique-se de configurar este ficheiro cuidadosamente.

Conceitos Avançados (Opcional)

Os seguintes três conceitos são para utilizadores avançados que querem personalizar profundamente o EasyClaw. Os principiantes podem saltar e voltar quando necessário.

🔀

Workflow (Automação de Processos)

Encadeie múltiplas tarefas do Agente em sequência lógica para formar um pipeline de automação repetível. Exemplo: "Receber email → Extrair informação chave → Gerar resumo → Enviar notificação Lark" é um Workflow típico.

📦

JSON (Formato de Troca de Dados)

Formato padrão para transferência de dados entre Agente e ferramentas/APIs externas. Quando pede ao Agente para chamar serviços de terceiros (como meteorologia, calendário, base de dados), os dados geralmente fluem em formato JSON. Não é necessário escrever manualmente, mas compreender a estrutura ajuda na resolução de problemas.

🔑

API Key (Credencial de Acesso)

Credencial de identidade para aceder a modelos de IA ou serviços de terceiros. O EasyClaw utiliza o sistema de créditos oficial por predefinição, não necessita de Key própria; utilizadores avançados podem preencher a sua própria API Key em "Adicionar Modelo Personalizado" para aceder a modelos especificados.

💡
Quando precisa de se preocupar com estes?
Quando quiser construir processos de automação complexos de múltiplos passos (Workflow), aceder à sua própria API Key para poupar custos, ou precisar de resolver problemas de transferência de dados entre Agente e ferramentas externas (JSON), estes três conceitos tornam-se muito úteis.
🎉
Referência Rápida de Conceitos
Agente = Colega de IA com poder de execução | Skills = Plugins de capacidade profissional | Prompt = Método de comunicação de alta qualidade | Memória = Repositório de memória de longo prazo | Soul = Constituição comportamental