O que agentforce-adlc faz?
Ciclo de Desenvolvimento de Agentes — Construa, implante, teste e otimize agentes Agentforce usando habilidades do Claude Code e a DSL Agent Script.
Visão Geral
Esta skill implementa o Ciclo de Desenvolvimento de Agentes (ADLC) para a plataforma Agentforce da Salesforce. Ela fornece um fluxo de trabalho orientado a código para:
- Construir definições de agentes usando a DSL Agent Script
- Implantar agentes diretamente na sua org Salesforce
- Testar comportamentos do agente com testes de unidade
- Otimizar prompts, tópicos e ações com base em feedback
Pré-requisitos
- Claude Code instalado (versão CLI ou IDE)
- Acesso a uma org Salesforce com Agentforce habilitado
- Salesforce CLI configurado com autenticação (
sf login org -a myorg) - Node.js v18+ e
npm
Instalação
# Instalar a skill no Claude Code
claude install SalesforceAIResearch/agentforce-adlc
Para usar sem instalação, execute comandos diretamente:
claude -p "Crie um novo agente Agentforce para suporte ao cliente" -s agentforce-adlc
Comandos Suportados
| Comando | Descrição |
|---|---|
adlc init | Inicializa um novo projeto ADLC no diretório atual |
adlc build | Compila arquivos .agent DSL em definições de agente compatíveis com Salesforce |
adlc deploy | Implanta o agente atual na org Salesforce padrão |
adlc test | Executa testes de unidade para tópicos e ações do agente |
adlc validate | Valida a sintaxe e as referências nos arquivos de definição do agente |
Estrutura de Projeto
meu-agente/
├── agent.agent # Definição principal do agente em DSL
├── topics/
│ ├── saudacao.topic
│ └── feedback.topic
├── actions/
│ ├── criarCaso.agent-action
│ └── buscarProduto.agent-action
├── tests/
│ └── saudacao.test.agent-test
└── prompts/
└── sistema.prompt
Guia Rápido
1. Inicializar um projeto
cd ~/projetos
claude adlc init meu-agente
cd meu-agente
2. Editar o arquivo agent.agent
agent "MeuPrimeiroAgente" {
descrição "Agente para triagem de chamados de suporte"
tópico "Saudação"
ação "Criar Caso"
}
3. Construir e validar
claude adlc build
claude adlc validate
4. Testar
claude adlc test
5. Implantar
claude adlc deploy -o minhaorg
Integração com Claude Code
Esta skill foi projetada para ser usada diretamente dentro do Claude Code. Você pode:
- Emitir comandos ADLC via chat do Claude
- Usar a skill como contexto para responder perguntas sobre desenvolvimento Agentforce
- Obter sugestões inteligentes para otimizar seu agente
Exemplo de prompt:
"Use a skill ADLC para adicionar um novo tópico de cancelamento de pedido ao meu agente e depois implante as alterações."
Solução de Problemas
| Problema | Causa Provável | Solução |
|---|---|---|
| Erro de autenticação | Org não configurada | Execute sf login org -a minhaorg |
| Falha na validação | Sintaxe DSL incorreta | Verifique agent.agent com adlc validate |
| Testes falhando | Tópico ou ação ausente | Confira se os arquivos estão em topics/ e actions/ |
Licença
MIT - Consulte o arquivo LICENSE para detalhes.