Skip to content

docs(traceai): OpenAI Go tracing (TH-8271) - #963

Merged
nik13 merged 6 commits into
mainfrom
feat/th-8271-openai-go
Nov 6, 2026
Merged

nik13 merged 6 commits into
mainfrom
feat/th-8271-openai-go

Conversation

@nik13

@nik13 nik13 commented Oct 16, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Adds the OpenAI Go guide for tracing Chat Completions from github.com/openai/openai-go/v3 with the released traceAI Go module.

  • src/pages/docs/integrations/traceai/go/openai.mdx: install, Future AGI OTLP/HTTP setup, middleware, sessions, a complete downloadable example with Go module initialization, captured fields, privacy settings, error behavior, unsupported surfaces and troubleshooting.
  • src/lib/integrations.mjs: registers the guide under Model providers as OpenAI Go.
  • examples/traceai/openai-go/: the complete example program and its run instructions.
  • scripts/integrations.test.mjs: page contract for catalog discovery, released module pins, the module bootstrap and the absence of internal test notes.

Versions

  • github.com/future-agi/traceAI/go/openai v0.1.0
  • github.com/openai/openai-go/v3 v3.78.0; supported from v3.71.1
  • OpenTelemetry Go SDK and OTLP/HTTP exporter v1.47.0
  • Go 1.26 or later

Closes TH-8271
Linear: TH-8271, TH-8272

🤖 Generated with Claude Code

Add the OpenAI Go page (src/pages/docs/integrations/traceai/go/openai.mdx)
for github.com/future-agi/traceAI/go/openai (traceAI PR #260): install,
the stock OTLP/HTTP exporter wiring Future AGI needs (both headers,
project_name, no gzip, flush on exit), the middleware, sessions and your
own spans, what is captured, the FI_HIDE_* privacy switches (content on by
default), errors/cancellation/retries, what is not supported, and how it
differs from the Python/JS/Java OpenAI packages and Arize's openai-go v1
module.

examples/traceai/openai-go holds the program the page describes, a
run_e2e.sh that builds it the documented way and sends default and hidden
runs, and tests that keep the page snippets in step with main.go.

No navigation.ts change; the nav PR adds the page.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
nik13 and others added 3 commits October 21, 2026 15:06
…e (TH-8271)

The page goes live only after traceAI#260 is merged and go/openai is tagged, so the
"until the PR is merged, fetch the PR commit" note would be stale on the live page.
Same for the example README. Install stays go get .../go/openai@latest.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Bring the OpenAI Go guide onto the current docs catalog and CI contract.

Co-Authored-By: Claude Code <noreply@anthropic.com>
Readers could not run the downloaded example because the guide did not
create a Go module before `go run`, and the page still mixed setup steps
with internal test notes. Pin the released traceAI and dependency modules,
add the complete download and module bootstrap, register the guide in the
integration catalog, and add a page contract for discovery and setup.

Co-Authored-By: Claude Code <noreply@anthropic.com>
@nik13
nik13 marked this pull request as ready for review November 6, 2026 05:38
The released module filters flattened message attributes independently of input.value and output.value. Explain that granular switches retain aggregate content, require both broad hide switches to withhold it, and preserve this warning in the integration page contract.

Co-Authored-By: Claude Code <noreply@anthropic.com>
Merge current main while preserving its integration catalog and page contracts. In released go/openai v0.1.0, generated tool arguments are outputs and tool results returned to the model are inputs; standalone tool attributes do not cover all copies. Explain why both privacy switches are needed across a conversation and guard that distinction in the page contract.

The released accumulator retains explicit API-reported input, output and total token zeros, so describe absent usage as not synthesized rather than saying usage is never zero. Verified against the v0.1.0 module from proxy.golang.org (request.go, response.go and traceconfig.go).

Co-Authored-By: Claude Code <noreply@anthropic.com>
@nik13
nik13 merged commit 69da59f into main Nov 6, 2026
8 checks passed
@nik13
nik13 deleted the feat/th-8271-openai-go branch November 6, 2026 08:00
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