Skip to content

docs(integrations): Exa tracing (TH-8324) - #996

Merged
nik13 merged 6 commits into
mainfrom
feat/th-8324-exa-docs
Nov 6, 2026
Merged

nik13 merged 6 commits into
mainfrom
feat/th-8324-exa-docs

Conversation

@nik13

@nik13 nik13 commented Oct 17, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Adds the Exa tracing guide at /docs/integrations/traceai/exa. It covers the released traceAI-exa client wrapper for exa-py, including install, setup, viewing traces, captured spans and attributes, privacy controls, troubleshooting and limitations.

  • Registers the page in src/lib/integrations.mjs (Frameworks & agents, traceAI SDK). navigation.ts stays unchanged.
  • Documents the released package ranges: Python 3.10 through 3.13, exa-py>=2.25.0,<3 and fi-instrumentation-otel>=1.1.0 (traceAI-exa 0.1.0 on PyPI).
  • Adds scripts/exa-page.test.mjs to check the catalog entry, the install and setup lines, and the privacy controls. It also fails if the test diary comes back.

Ticket: TH-8324. Package source: future-agi/traceAI#205.

🤖 Generated with Claude Code

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
nik13 and others added 2 commits October 17, 2026 03:36
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…aclose() (TH-8324)

Removes 'until a release is on PyPI, install from the repository', which would be stale once the page is live. exa-py 2.26.0 (2026-10-19) adds its own async aclose(); the package suite passes on it (traceAI#205), so the tested-versions text says so, and the stream troubleshooting entry names aclose() for AsyncExa streams.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
nik13 and others added 2 commits November 5, 2026 21:04
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
traceAI-exa 0.1.0 is released, so the guide no longer needs the dated live-run section, trace IDs, internal project name or tested-versions table that read like a test diary.

The page now states the Python and exa-py ranges from the package metadata, flushes spans at the end of the example so a short script exports them, adds a short view-the-trace step and explains the get_contents URL opt-in. It registers the route in the shared integrations catalog, which is how docs navigation and discovery now work, and adds a page contract test so the diary does not come back.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@nik13
nik13 marked this pull request as ready for review November 6, 2026 05:36
Explain that the privacy-configured call replaces the initial instrumentation in step 3, and that FI_HIDE_INPUTS must be set before the first call. Repeated instrument calls and later environment changes do not update the released instrumentor's existing wrappers. Add page-contract coverage for the setup ordering and replacement guidance.

Co-Authored-By: Claude Code <noreply@anthropic.com>
@nik13
nik13 merged commit 98ae423 into main Nov 6, 2026
8 checks passed
@nik13
nik13 deleted the feat/th-8324-exa-docs branch November 6, 2026 07:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant