1. promptlayer_client.run – zero-setup SDK sugar
2. Webhook-driven caching – maintain local cache of prompt templates
3. Managed Agents – let PromptLayer orchestrate everything server-side

​

Use promptlayer_client.run (quickest path)

1. Fetch latest prompt – We pull the template (by version or release label) from PromptLayer.
2. Execute – The SDK sends the populated prompt to OpenAI, Anthropic, Gemini, etc.
3. Log – The raw request/response pair is saved back to PromptLayer.

from promptlayer import PromptLayer
pl_client = PromptLayer(api_key="...")

response = pl_client.run(
    prompt_name="order-summary",
    input_variables={"cart": cart_items},
    prompt_release_label="prod"
)

1. SDK pulls the latest prompt (or the version/label you specify).
2. Your client calls the model provider (OpenAI, Anthropic, Gemini, …).
3. SDK writes the log back to PromptLayer.

💡 Tip – If latency is critical, enqueue the log to a background worker and let your request return immediately.

​

Cache prompts with Webhooks

​

Step‑by‑step

1. Subscribe to webhooks in the UI

2. Maintain a local cache

# pseudocode
def handle_pl_webhook(event):
    prompt = event["data"]
    db.prompts.upsert(prompt["prompt_template_name"], prompt)

3. Serve traffic

prompt = db.prompts.get("order-summary")
llm_response = openai.chat.completions.create(...)
queue.enqueue(track_to_promptlayer, llm_response)

Tip: Most teams push the track_to_promptlayer onto a Redis or SQS queue so as to not block on the logging of a request.

​

Run fully-managed Agents

​

How it works

1. Define multi-step workflows in PromptLayer’s Agent Builder
2. Trigger agent execution via API
3. Monitor execution on PromptLayer servers
4. Receive results via webhook or polling

​

Implementation

from promptlayer import PromptLayer
promptlayer_client = PromptLayer(api_key="…")

execution = promptlayer_client.run_workflow(  # SDK method
    workflow_name="customer_support_agent",   # <- this is an Agent
    workflow_label_name="prod",
    input_variables={"ticket_id": 123}
)

​

Which pattern should I pick?

​

Further reading 📚

• Quickstart – Your first prompt
• Webhooks – Events & signature verification
• Agents – Concepts & versioning
• CI for prompts – Continuous Integration guide

✉️ Need a hand? Ping us in Discord or email hello@promptlayer.com—happy to chat architecture!