Skip to content

Instantly share code, notes, and snippets.

@RichardBray

RichardBray/new_sapient_prompts.md

Created May 5, 2026 20:08
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save RichardBray/095699a0f2580e7d55e2c0eaac8d802f to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save RichardBray/095699a0f2580e7d55e2c0eaac8d802f to your computer and use it in GitHub Desktop.
Download ZIP
new sapient prompts
Raw
new_sapient_prompts.md

Rewritten Agent Test Prompts

1. POST /webhooks/agent.started

  • Old prompt: "Using https://docs.firecrawl.dev, integrate POST /webhooks/agent.started from Firecrawl's API into my codebase and test it out. Write a Python script."
  • New prompt: "Write a Python script that listens for when a Firecrawl agent starts running and logs the event."
  • Changes:
    • Replaced endpoint path with the user's actual goal ("listens for when an agent starts")
    • Leads with the deliverable instead of the docs URL

2. GET /v2/team/token-usage/historical

  • Old prompt: "Using https://docs.firecrawl.dev, integrate GET /v2/team/token-usage/historical from Firecrawl's API into my codebase and test it out. Write a Python script."
  • New prompt: "Write a Python script that pulls my team's historical token usage from Firecrawl and prints a summary."
  • Changes:
    • "Historical token usage" is how a human thinks about it — not the endpoint path
    • Added a concrete output goal ("prints a summary") so the agent knows what "test it" means

3. DELETE /v2/scrape/{jobId}/interact

  • Old prompt: "Using https://docs.firecrawl.dev, integrate DELETE /v2/scrape/{jobId}/interact from Firecrawl's API into my codebase and test it out. Write a Python script."
  • New prompt: "Write a Python script that ends an active interaction session on a Firecrawl scrape job. It should start a scrape, interact with it, then close the session and confirm it's gone."
  • Changes:
    • Describes the full workflow a human would actually need — nobody calls a DELETE in isolation
    • "Close the session and confirm it's gone" replaces "test it out" with a verifiable outcome

4. POST /v2/parse

  • Old prompt: "Using https://docs.firecrawl.dev, integrate POST /v2/parse from Firecrawl's API into my codebase and test it out. Write a Python script."
  • New prompt: "Write a Python script that uploads a document to Firecrawl and extracts the structured content from it."
  • Changes:
    • "Uploads a document and extracts structured content" describes what parse does from the user's perspective

5. POST /v2/map

  • Old prompt: "Using https://docs.firecrawl.dev, integrate POST /v2/map from Firecrawl's API into my codebase and test it out. Write a Python script."
  • New prompt: "Write a Python script that takes a URL and uses Firecrawl to discover all the pages on that site. Print the list of URLs it finds."
  • Changes:
    • "Discover all the pages on a site" is how someone describes mapping — the word "map" is Firecrawl-specific
    • Input and output are both specified naturally

Why the docs URLs were removed

Real users don't preemptively hand an agent a docs link, they describe what they want and expect it to work.

Since these prompts are testing docs usability from a real user's perspective, the prompts should reflect how people actually talk to agents.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment