forcedotcom/sf-skills / skills/sales-agentforce-pipeline-management-configure
sales-agentforce-pipeline-management-configure
VerifiedUse to configure, set up, or repair the Sales Management agent and Agentforce Pipeline Management in a Salesforce org. Automates metadata creation for flows, prompt templates, permission sets, and data source configuration. TRIGGER when: user wants to enable Pipeline Management, configure Sales pipeline features, set up the Sales Management agent for opportunity field updates (including autonomous updates), connect enabled data sources like Einstein Conversation Insights or Einstein Activity Capture, customize opportunity stage descriptions, configure post-meeting suggestions, verify or audit configuration status, fix partially configured orgs, or troubleshoot Pipeline Management metadata issues. DO NOT TRIGGER when: user wants to build a custom agent (use agentforce-generate), configure general Agentforce tracing (use platform-tracing-agentforce-configure), work with non-Sales agents, or enable Einstein Conversation Insights or Einstein Activity Capture from scratch (provisioning is out of scope).
scripts/shared/agent-bundle-publish.sh
View on GitHub#!/bin/bash
# Shared library for Sales Agent authoring bundle publish and activation
#
# Functions:
# publish_and_activate_agent <org-alias> <on-error-behavior> [output-style]
#
# Parameters:
# org-alias: Salesforce org alias
# on-error-behavior: "exit" (hard fail on error) or "return" (return non-zero)
# output-style: "plain" (default, plain echo) or "structured" (log_pass/log_info style)
#
# Returns:
# 0 on success
# 1 on failure
#
# Environment:
# SCRIPT_DIR must be set (parent script's directory)
# Source agent-detection helpers (pm_bot_latest_version, etc.)
# Use a local resolution that doesn't depend on the caller's SCRIPT_DIR.
# shellcheck source=./agent-detection.sh
source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/agent-detection.sh"
publish_and_activate_agent() {
local ORG_ALIAS="$1"
local ON_ERROR="${2:-exit}"
local OUTPUT_STYLE="${3:-plain}"
# Clear exported state from any prior call to prevent stale values on failure
unset AGENT_VERSION
unset AGENT_API_NAME
local AGENT_BUNDLE="$SCRIPT_DIR/../assets/sales_management_agent.agent"
local BUNDLE_META="$SCRIPT_DIR/../assets/sales_management_agent.bundle-meta.xml"
# Output helper functions based on style
local msg_header msg_pass msg_error msg_info
if [[ "$OUTPUT_STYLE" == "structured" ]]; then
msg_header() { log_info "$1"; }
msg_pass() { log_pass "$1"; }
msg_error() { echo " ERROR: $1"; }
msg_info() { echo " $1"; }
else
msg_header() { echo "=== $1 ==="; }
msg_pass() { echo " ✓ $1"; }
msg_error() { echo " ERROR: $1"; }
msg_info() { echo " $1"; }
fi
# Check for bundle assets
if [[ ! -f "$AGENT_BUNDLE" || ! -f "$BUNDLE_META" ]]; then
msg_error "Agent bundle assets not found at: $AGENT_BUNDLE"
if [[ "$ON_ERROR" == "exit" ]]; then
echo ""
echo "SETUP FAILED: A Pipeline Management BotDefinition is REQUIRED for user interaction."
exit 1
fi
return 1
fi
msg_header "Creating Sales Agent via authoring bundle"
# Create temp directory for bundle deployment
local TEMP_DIR
TEMP_DIR=$(mktemp -d -t sales-agent-bundle.XXXXXX)
# Use EXIT trap so it fires even on explicit exit calls
trap 'rm -rf "$TEMP_DIR"' EXIT
# Create sfdx-project.json in temp dir
cat > "$TEMP_DIR/sfdx-project.json" << 'SFDX'
{"packageDirectories": [{"path": "force-app", "default": true}], "sourceApiVersion": "67.0"}
SFDX
# Copy authoring bundle to temp deployment directory
mkdir -p "$TEMP_DIR/force-app/main/default/aiAuthoringBundles/SalesAgent"
if ! cp "$AGENT_BUNDLE" "$TEMP_DIR/force-app/main/default/aiAuthoringBundles/SalesAgent/SalesAgent.agent"; then
msg_error "Failed to stage bundle agent file"
rm -rf "$TEMP_DIR"
trap - EXIT
if [[ "$ON_ERROR" == "exit" ]]; then
echo ""
echo "SETUP FAILED: A Pipeline Management BotDefinition is REQUIRED for user interaction."
exit 1
fi
return 1
fi
if ! cp "$BUNDLE_META" "$TEMP_DIR/force-app/main/default/aiAuthoringBundles/SalesAgent/SalesAgent.bundle-meta.xml"; then
msg_error "Failed to stage bundle metadata file"
rm -rf "$TEMP_DIR"
trap - EXIT
if [[ "$ON_ERROR" == "exit" ]]; then
echo ""
echo "SETUP FAILED: A Pipeline Management BotDefinition is REQUIRED for user interaction."
exit 1
fi
return 1
fi
# Publish authoring bundle from temp directory
msg_info "Publishing Sales Agent authoring bundle..."
local PUBLISH_RESULT
PUBLISH_RESULT=$(cd "$TEMP_DIR" && sf agent publish authoring-bundle --json --api-name SalesAgent --target-org "$ORG_ALIAS" 2>/dev/null || echo '{"status":1}')
if ! echo "$PUBLISH_RESULT" | jq -e '.status == 0' >/dev/null 2>&1; then
local PUBLISH_ERR
PUBLISH_ERR=$(echo "$PUBLISH_RESULT" | jq -r '.message // .result.message // .result.errors[0].message // "unknown"' 2>/dev/null || echo "unknown")
msg_error "Authoring bundle publish failed: $PUBLISH_ERR"
rm -rf "$TEMP_DIR"
trap - EXIT
if [[ "$ON_ERROR" == "exit" ]]; then
echo ""
echo "SETUP FAILED: A Pipeline Management BotDefinition is REQUIRED for user interaction."
exit 1
fi
return 1
fi
msg_pass "Sales Agent published successfully"
# Query for the latest BotVersion with retry (async provisioning).
# Match the bot by AgentTemplate (the same field the scheduled flow uses),
# not by hardcoded DeveloperName — the bundle may publish under a different
# local name in some orgs.
msg_info "Querying for latest version..."
local LATEST_VERSION=""
for attempt in {1..3}; do
LATEST_VERSION=$(pm_bot_latest_version "$ORG_ALIAS")
if [[ -n "$LATEST_VERSION" ]]; then
break
fi
if [[ $attempt -lt 3 ]]; then
echo " Version not yet available, retrying in 5s... (attempt $attempt/3)"
sleep 5
fi
done
if [[ -z "$LATEST_VERSION" ]]; then
msg_error "Could not query BotVersion after publish. BotDefinition may still be provisioning. Wait 30s and check Setup → Agents."
rm -rf "$TEMP_DIR"
trap - EXIT
if [[ "$ON_ERROR" == "exit" ]]; then
echo ""
echo "SETUP FAILED: A Pipeline Management BotDefinition is REQUIRED for user interaction."
exit 1
fi
return 1
fi
# Resolve the actual published DeveloperName from AgentTemplate so we
# activate whatever name the bundle landed under (defaults to "SalesAgent"
# but the org may already have an upgraded NGA bot with a different name).
AGENT_API_NAME=$(pm_bot_developer_name "$ORG_ALIAS")
if [[ -z "$AGENT_API_NAME" ]]; then
AGENT_API_NAME="SalesAgent"
fi
# Activate the agent with dynamic version
msg_info "Activating $AGENT_API_NAME version $LATEST_VERSION..."
local ACTIVATE_RESULT
ACTIVATE_RESULT=$(sf agent activate --api-name "$AGENT_API_NAME" --version "$LATEST_VERSION" --target-org "$ORG_ALIAS" --json 2>/dev/null || echo '{"status":1}')
if ! echo "$ACTIVATE_RESULT" | jq -e '.status == 0' >/dev/null 2>&1; then
local ACTIVATE_ERR
ACTIVATE_ERR=$(echo "$ACTIVATE_RESULT" | jq -r '.message // .result.message // .result.errors[0].message // "unknown"' 2>/dev/null || echo "unknown")
msg_error "Agent activation failed: $ACTIVATE_ERR. The agent was published but activation failed."
rm -rf "$TEMP_DIR"
trap - EXIT
if [[ "$ON_ERROR" == "exit" ]]; then
echo ""
echo "SETUP FAILED: A Pipeline Management BotDefinition is REQUIRED for user interaction."
exit 1
fi
return 1
fi
msg_pass "$AGENT_API_NAME activated successfully (version $LATEST_VERSION)"
# Export version and resolved api-name for caller to use
export AGENT_VERSION="$LATEST_VERSION"
export AGENT_API_NAME
# Clean up temp directory before returning (EXIT trap only fires on exit, not return)
rm -rf "$TEMP_DIR"
trap - EXIT # Remove the trap since we've already cleaned up
return 0
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |