Worker Configuration — Habilidades e Ferramentas (Skills & Tools)

URL: https://app.getdarwin.ai/ou/{orgId}/workforce/worker/{workerId}?tab=toolbox

---

1. Habilidades (Skills)

"Uma habilidade é um conjunto de instruções reutilizáveis que ensinam seu worker a realizar uma tarefa que aparece com frequência, por exemplo agendar uma reunião no Google Calendar ou buscar um cliente no seu CRM. Você escreve as instruções uma única vez e, se quiser, adiciona as ferramentas que a tarefa precisa. A partir daí você pode reutilizar essa habilidade em quantas etapas do pipeline quiser: quando você a anexa a uma etapa, suas instruções são adicionadas a essa etapa automaticamente, então você nunca precisa copiar e reescrever o mesmo prompt."

1.1 Suas Habilidades (Painel Esquerdo)

Elemento	Descrição
Título	"Suas habilidades" (heading 6)
Descrição	"As habilidades que você criou para este worker."
Estado vazio	"Ainda não há habilidades. Clique em 'Adicionar habilidade' para criar uma."
Adicionar habilidade	Button — Cria uma nova habilidade personalizada

1.2 Configuração da Habilidade (Painel Direito)

Elemento	Tipo	Descrição
Buscar habilidades	Textbox	Pesquisa na biblioteca de habilidades
Destaques	Button (filtro)	Habilidades em destaque
Todos	Button (filtro)	Todas as habilidades
Agendamento	Button (filtro)	Habilidades de agendamento/calendário
CRM	Button (filtro)	Habilidades de CRM
Planilhas	Button (filtro)	Habilidades de planilhas
Paginação	Navegação	Página X de Y

1.3 Biblioteca de Habilidades Pré-construídas

Habilidade	Descrição	Integração
Habilidade em branco	Começar do zero	—
Agendar reuniões no Google Calendar	Verifique disponibilidade e agende reuniões	Google Calendar
Buscar informações no HubSpot	Procure contatos, empresas e negócios	HubSpot
Criar ou atualizar um cliente no HubSpot	Crie um novo contato ou atualize um existente	HubSpot
Buscar informações no Google Sheets	Procure linhas em uma planilha por coluna-chave	Google Sheets

---

1.3 Painel: Habilidade em Branco (Nova Skill)

Ao clicar em "Habilidade em branco":

Elemento	Descrição
Configuração da habilidade	Heading 6
Trocar habilidade	Button — voltar à biblioteca

Campos:

Campo	Obrigatório	Descrição
Nome da habilidade *	✅	Nome único da skill
Instruções	—	Textbox multiline — prompt da skill
Ferramentas opcionais	—	Combobox multiselect + "Adicionar nova ferramenta"

Ações: Cancelar / Salvar (desabilitado até preencher Nome)

---

1.4 Painel: Skill Pré-construída (Google Calendar)

Ao selecionar uma skill pronta:

Campo	Conteúdo (ex: Google Calendar)
Nome da habilidade *	"Agendar reuniões no Google Calendar"
Seletor de Idioma	Combobox PT/EN/ES
Instruções	Fluxo de 5 passos: Disponibilidade → Coletar dados → Agendar → Confirmar → Reagendar. Usa variável {date}.
Ferramentas necessárias	Google Calendar com "Conectar Google Calendar"

Ações: Cancelar / Salvar (desabilitado, tooltip: "Conecte as ferramentas necessárias para salvar esta habilidade.")

⚠️ Skills pré-construídas exigem ferramentas CONECTADAS. Skills em branco têm ferramentas opcionais.

---

2. Ferramentas (Tools)

"Uma ferramenta é uma conexão com um serviço externo que seu worker pode usar enquanto conversa com um cliente. Você pode conectá-la a mais de 1.000 apps e serviços para que seu worker aja por conta própria, por exemplo consultar disponibilidade e agendar um evento em um calendário, buscar ou atualizar um contato em um CRM, ler uma linha de uma planilha, ou chamar sua própria API. Você conecta uma ferramenta aqui uma única vez e depois pode usá-la de duas formas: habilitá-la nas etapas do pipeline onde o worker deva tê-la, ou anexá-la a uma habilidade para que a ferramenta acompanhe essa habilidade onde quer que ela seja usada."

2.1 Suas Ferramentas (Painel Esquerdo)

Elemento	Descrição
Título	"Suas ferramentas" (heading 6)
Descrição	"As ferramentas que você conectou para este worker."
Estado vazio	"Comece adicionando sua primeira ferramenta para desbloquear as capacidades deste funcionário-IA."
Adicionar Ferramenta	Button — Conecta uma nova ferramenta

2.2 Configuração de Ferramenta (Painel Direito)

Elemento	Tipo	Descrição
Título	Heading 6	"Configuração de Ferramenta"
Instrução	Texto	"Os campos obrigatórios estão marcados com *."
Tipo de Ferramenta *	Campo obrigatório	"Conecte seu Funcionário-IA a mais de 1.000 aplicativos e ferramentas."
Buscar apps e ferramentas...	Textbox	Pesquisa na biblioteca de integrações

2.3 Ferramentas Disponíveis

Ferramenta	Categoria
Custom HTTP Request	API Personalizada
FireCrawl	Web Scraping
Google Calendar	Calendário
Google Drive	Armazenamento
Google Sheets	Planilhas
HubSpot	CRM
Pipedrive	CRM
Salesforce	CRM
Zoho CRM	CRM

2.3 Configuração Completa: Custom HTTP Request

Ao selecionar "Custom HTTP Request":

Cabeçalho: "Selecionado: Custom HTTP Request" + "Alterar seleção". Suporta GET/POST/PUT/DELETE/PATCH com headers e payloads. (Requer contato com equipe Darwin para gerar — sem autoatendimento.)

Campos Obrigatórios:

Campo	Tipo	Descrição
Nome *	Textbox	Título curto e único (ex: "CRM Webhook")
URL *	Textbox	URL HTTPS do endpoint MCP (deve terminar com /sse)
Método *	Combobox	GET, POST, PUT, DELETE, PATCH
Endpoint *	Textbox	Caminho do endpoint

Campos Opcionais:

Campo	Descrição
Descrição	Resumo de uma frase da integração
Importar de cURL / JSON	Importa configuração pronta

Incluir Resposta: Body ✅ (default) / Status ✅ (default)

Headers: "Adicionar Headers" — Authorization, Content-Type, Accept, Cache-Control

Body: Toggle Formulário (key-value) / JSON (raw). "Adicionar Campos de Body"

Inputs: "Detectar inputs" + "Adicionar Input". Contexto ex: "O e-mail fornecido pelo humano como string."

Salvar: Desabilitado até preencher Nome, URL, Método, Endpoint

2.4 Ferramentas OAuth (Google, HubSpot, etc.)

Fluxo de autorização OAuth específico de cada serviço (conectar conta, autorizar permissões).

---

3. Comparativo: Skill em Branco vs Pré-construída

Característica	Em Branco	Pré-construída
Instruções	Vazias	Fluxo detalhado com {date}
Idioma	—	Seletor PT/EN/ES
Ferramentas	Opcionais	Necessárias
Salvar liberado	Após Nome	Após conectar ferramentas

---

4. Relacionamentos

Módulo	Relação
Automação de Etapas	Skills/tools vinculadas via @Nome
Pipelines	Instruções da skill injetadas na etapa
Workflows (Albato)	Integrações complementares
Base de Conhecimento	Tools podem consultar dados