Skip to content

docs(cloudflare): Add Clef to the Workers AI evaluation tracing section - #19877

Merged
JPeer264 merged 1 commit into
masterfrom
jp/workers-ai-clef
Oct 9, 2026
Merged

docs(cloudflare): Add Clef to the Workers AI evaluation tracing section#19877
JPeer264 merged 1 commit into
masterfrom
jp/workers-ai-clef

Conversation

@JPeer264

@JPeer264 JPeer264 commented Oct 9, 2026

Copy link
Copy Markdown
Member

DESCRIBE YOUR PR

This adds the Clef model (@cf/cloudflare/clef) to the Workers AI evaluation section. Clef takes the same state and questions input as Jev, so the SDK traces it as a gen_ai.evaluate span (by model ID since getsentry/sentry-javascript#25027, SDK 11.5.0). The section anchor changes, so this also updates the link from the TypeSafe page.

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.
Select exactly one option. For deadlines, replace YYYY-MM-DD with the due date. You can update this information later by editing the PR description.

  • Urgent deadline (GA date, etc.): YYYY-MM-DD
  • Other deadline: YYYY-MM-DD
  • No deadline: Not urgent, can wait up to 1 week+

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've supplied a deadline.

Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

LEGAL BOILERPLATE

Look, I get it. The entity doing business as "Sentry" was incorporated in the State of Delaware in 2015 as Functional Software, Inc. and is gonna need some rights from me in order to utilize my contributions in this here PR. So here's the deal: I retain all rights, title and interest in and to my contributions, and by keeping this boilerplate intact I confirm that Sentry can use, modify, copy, and redistribute my contributions, under Sentry's choice of terms.

EXTRA RESOURCES

@vercel

vercel Bot commented Oct 9, 2026 •
edited
Loading

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
sentry-docs Ready Ready Preview Oct 9, 2026 12:26pm UTC
1 Skipped Deployment
Project Deployment Actions Updated
develop-docs Ignored Ignored Preview Oct 9, 2026 12:26pm UTC

Request Review

@github-actions github-actions Bot added the Priority: Normal Docs review has no urgent deadline label Oct 9, 2026
@JPeer264
JPeer264 force-pushed the jp/workers-ai-clef branch from 9d348c8 to 3b4b16f Compare October 9, 2026 09:33
@JPeer264 JPeer264 self-assigned this Oct 9, 2026
@JPeer264
JPeer264 marked this pull request as ready for review October 9, 2026 10:08
@JPeer264
JPeer264 requested a review from andreiborza October 9, 2026 10:08
@cursor

cursor Bot commented Oct 9, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

The plan checks the published Workers AI page for the new Clef heading. It also checks client errors on that page and on TypeSafe pages. An issue escalates when those errors appear or the Clef heading is missing.

Rollout complete

Services: sentry-docs.

Plan

What changed

The Workers AI page now documents Clef evaluations the same way as Jev. The TypeSafe page link now targets #trace-jev-and-clef-evaluations. This ships when sentry-docs deploys. Catalog id sentry-docs matches the Vercel project in the deploy workflow, and the files live under product docs.

Risk

Bad MDX can 404 the Workers AI page or break TypeSafe pages that share the same app. The heading change drops the old #trace-jev-evaluations jump, so that hash no longer reaches the section.

Intended effect

This is a docs copy change. Sentry has no counter for the new Clef text. Confirm the published pages. Absent means the Workers AI heading is still Trace Jev Evaluations and the body has no @cf/cloudflare/clef.

Signal Baseline Rule Source
Workers AI page heading and Clef example Heading is Trace Jev Evaluations. Body has no Clef. Measured 2026-10-09T10:09Z. Confirmed when heading is Trace Jev and Clef Evaluations and body has @cf/cloudflare/clef. Absent when the heading is still Trace Jev Evaluations. GET https://docs.sentry.io/platforms/javascript/guides/cloudflare/agent-tracing/workers-ai/
TypeSafe Node page Workers AI href Live page still links to the Workers AI section. Hash on that live page is the old heading. Measured 2026-10-09T10:09Z. Confirmed when the Workers AI href ends with #trace-jev-and-clef-evaluations. Absent when it still ends with #trace-jev-evaluations. GET https://docs.sentry.io/platforms/javascript/guides/node/configuration/integrations/typesafe/

Regression watch

A bad page can throw in the client or stop serving. Watch errors on the changed paths. Also watch sibling Cloudflare agent-tracing pages. TracesSampleRate is 0.3, so a short spike can be missed. Traffic on this path is low.

Signal Baseline Rule Source
Client error count on Workers AI page 0 events in 2026-10-08T10:09:40Z to 2026-10-09T10:09:40Z. Also 0 events in the prior 7d. Hold at 0. Escalate if the 24h count rises above 0. Sentry org sentry, project docs. environment:production AND transaction:"/platforms/javascript/guides/cloudflare/agent-tracing/workers-ai/". Dataset errors. count().
Client error count on TypeSafe pages 0 events in 2026-10-08T10:09:40Z to 2026-10-09T10:09:40Z. Hold at 0 for 24h. Escalate if the 24h count rises above 0, except the known 7d title below. Sentry org sentry, project docs. environment:production AND url:*configuration/integrations/typesafe*. Dataset errors. count().
Client error count on Cloudflare agent-tracing pages 0 events in 2026-10-08T10:09:40Z to 2026-10-09T10:09:40Z. Hold at 0. Escalate if the 24h count rises above 0. Sentry org sentry, project docs. environment:production AND transaction:/platforms/javascript/guides/cloudflare/agent-tracing/*. Dataset errors. count().
Request volume for the Workers AI URL 43 spans in 2026-10-08T10:09:40Z to 2026-10-09T10:09:40Z. About 1.8 spans per hour. Stay above 0. A fall to 0 while sibling Cloudflare docs still have traffic means the page is gone. Do not use p95 from this query. The mix of span ops made p95 46896ms. Sentry org sentry, project docs. environment:production AND (transaction.op:pageload OR span.op:http.client) AND (transaction:"/platforms/javascript/guides/cloudflare/agent-tracing/workers-ai/" OR http.url:*platforms/javascript/guides/cloudflare/agent-tracing/workers-ai/*). Dataset spans. count().

The TypeSafe URL had 25 errors in 2026-10-02T10:09:40Z to 2026-10-09T10:09:40Z. All used title Event: Event Event (type=error) captured as promise rejection. That title was 0 in the last 24h. Treat a return of that title at similar 7d volume as prior noise, not as this change.

Not observable

Hash jumps to #trace-jev-evaluations have no telemetry. Pageload latency is not usable. transaction.op:pageload on the Workers AI transaction returned 0 spans in 24h. Whether readers notice the Clef example is not measured.

Get Slack DMs about this change: cursor.com/automations/rollouts

sentry[bot]
sentry Bot reviewed Oct 9, 2026
View reviewed changes
Comment thread docs/platforms/javascript/guides/cloudflare/agent-tracing/workers-ai.mdx
andreiborza
andreiborza approved these changes Oct 9, 2026
View reviewed changes

@andreiborza andreiborza left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice

@JPeer264 @claude
docs(cloudflare): Add Clef to the Workers AI evaluation tracing section
4f0ee42 
Clef takes the same state and questions input as Jev, so its calls become
gen_ai.evaluate spans too.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
@JPeer264
JPeer264 force-pushed the jp/workers-ai-clef branch from 3b4b16f to 4f0ee42 Compare October 9, 2026 12:20
@JPeer264
JPeer264 enabled auto-merge (squash) October 9, 2026 12:23
@JPeer264
JPeer264 merged commit 44d39d9 into master Oct 9, 2026
25 checks passed
@JPeer264
JPeer264 deleted the jp/workers-ai-clef branch October 9, 2026 12:32
@cursor

cursor Bot commented Oct 9, 2026

Copy link
Copy Markdown
Contributor

Verified in production

  • The published Workers AI page shows the new Clef heading.

This branch was successfully deployed

1 active deployment
Preview – sentry-docs — 4f0ee42a Deployed Oct 9, 2026 by vercel[bot]
View deployment
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@sentry sentry[bot] sentry[bot] left review comments
@andreiborza andreiborza andreiborza approved these changes

Assignees

@JPeer264 JPeer264

Labels

Priority: Normal Docs review has no urgent deadline

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@JPeer264 @andreiborza