Marketplace Prompt Loading

pip install -U swarms

export SWARMS_API_KEY="your-api-key-here"

from swarms import Agent

agent = Agent(
    model_name="gpt-4.1-mini",
    marketplace_prompt_id="your-prompt-uuid-here",
    max_loops=1,
)

response = agent.run("Your task here")
print(response)

from swarms import Agent

# Create an agent with a marketplace prompt
agent = Agent(
    model_name="gpt-4.1-mini",
    marketplace_prompt_id="0ff9cc2f-390a-4eb1-9d3d-3a045cd2682e",
    max_loops="auto",
    interactive=True,
)

# Run the agent - it uses the system prompt from the marketplace
response = agent.run("Hello, what can you help me with?")
print(response)

🛒 [MARKETPLACE] Loaded prompt 'Your Prompt Name' from Swarms Marketplace

from swarms import Agent

agent = Agent(
    # Marketplace prompt
    marketplace_prompt_id="your-prompt-uuid",
    
    # Model configuration
    model_name="gpt-4.1",
    max_tokens=4096,
    temperature=0.7,
    
    # Agent behavior
    max_loops=3,
    verbose=True,
    
    # Tools
    tools=[your_tool_function],
)

agent = Agent(
    marketplace_prompt_id="your-prompt-uuid",
    agent_name="My Custom Agent Name",  # This overrides the marketplace name
    agent_description="My custom description",  # This overrides the marketplace description
    model_name="gpt-4.1-mini",
)

# This will raise a ValueError with a helpful message
agent = Agent(
    marketplace_prompt_id="non-existent-id",
    model_name="gpt-4.1-mini",
)
# ValueError: Prompt with ID 'non-existent-id' not found in the marketplace.
# Please verify the prompt ID is correct.

# This will raise a ValueError
agent = Agent(
    marketplace_prompt_id="your-prompt-uuid",
    model_name="gpt-4.1-mini",
)
# ValueError: Swarms API key is not set. Please set the SWARMS_API_KEY environment variable.
# You can get your key here: https://swarms.world/platform/api-keys