Java SDK: document embedding/retrieval annotation

[ebrevan]

What does this PR do? What is the motivation?

Adds documentation for two new Java SDK methods, annotateEmbeddingIO() and annotateRetrievalIO(), introduced in dd-trace-java#12149. These methods let customers annotate embedding and retrieval spans with structured document objects (LLMObs.Document) rather than plain strings, giving the trace view richer context for those span types.

The changes land in the Java tab of Enriching spans > Annotating inputs and outputs in the LLM Observability SDK reference page.

Changes:

• Updates the section intro to cover all three annotation methods and states which span kind each targets.
• Renames the existing #### Arguments heading to #### annotateIO() arguments for clarity.
• Adds #### annotateEmbeddingIO() arguments and #### annotateRetrievalIO() arguments subsections, each documenting its parameters and preserving the existing null/empty-argument behavior guidance.
• Adds a #### Documents subsection documenting how to construct LLMObs.Document values (required text; optional name, id, score), parallel to the existing #### LLM Messages subsection.
• Expands #### Example to #### Examples and adds concise embedding-span and retrieval-span code examples alongside the existing LLM-span example.
• Notes that annotateEmbeddingIO() and annotateRetrievalIO() require dd-trace-java 1.66.0 or later.

Merge readiness

• Ready for merge

For Datadog employees:

• ⚠️ Your branch name MUST follow the <name>/<description> convention and include the forward slash (/). If you've already created your PR with an incorrect branch name, please rename your branch and open a fresh PR.
• 🤖 New: Comment with /review to run an automated check that catches common issues before a Documentation team member reviews your PR.

AI assistance

Used Claude Code (Bits Code) to draft, structure, and write the documentation changes.

Additional notes

Source PR: DataDog/dd-trace-java#12149

NOTE: some AI-generated links and images were removed to ensure safety.

---

PR by Bits - View session in Datadog

Comment @datadog-staging to request changes

[datadog-staging]

View session in Datadog

Bits Code status: ✅ Done

Comment @datadog-staging to request changes

[datadog-staging]

I can only run on private repositories.

[github-actions]

Preview links (active after the build_preview check completes)

Modified Files

• https://docs-staging.datadoghq.com/dd/edgardo/java-llmobs-document-annotation-20260810/llm_observability/instrumentation/sdk