opentelemetry-instrumentation-genai-llama-index gaps vs openinference instrumentation

Ready to Fix

Missing Spans

• Add AgentWorkflow.run span (llama_index.core.agent.workflow.AgentWorkflow.run) - maps to GenAI invoke_workflow (in progress in #495)
• Add generic Workflow.run span (llama_index.core.workflow.Workflow.run) - maps to GenAI invoke_workflow (#567)
• Add retrieval span (llama_index.core.base.base_retriever.BaseRetriever.retrieve / _retrieve, aretrieve / _aretrieve) - maps to GenAI retrieval (in progress in #502)

Missing Attributes & Features

None

Blocked on Semantic Conventions

Missing Spans

• Add generic workflow step span (llama_index.core.workflow.Workflow @step methods / WorkflowStepOutputEvent) (https://github.com/open-telemetry/semantic-conventions-genai/issues/188)
• Add reranker span (ReRankStartEvent / ReRankEndEvent) (https://github.com/open-telemetry/semantic-conventions-genai/issues/253)

Missing Attributes & Features

• Capture reranker attributes (OpenInference: reranker.query, reranker.model_name, reranker.top_k, reranker.input_documents, reranker.output_documents) (https://github.com/open-telemetry/semantic-conventions-genai/issues/253)
• Capture document metadata in retrieval results (OpenInference: document.metadata)

Gaps for Legacy APIs

• Add legacy agent spans (llama_index.core.agent.runner.base.AgentRunner.chat / run_step, BaseAgent / BaseAgentWorker) - maps to GenAI invoke_agent
• Support legacy callback handler (llama_index.core.global_handler / OpenInferenceTraceCallbackHandler via use_legacy_callback_handler)

Start by reviewing the listed LlamaIndex entry points, including AgentWorkflow.run, Workflow.run, BaseRetriever.retrieve/_retrieve and aretrieve/_aretrieve, plus the legacy agent APIs. Check the linked issues #495, #502, #567 and the semantic-convention blockers before choosing work; done means the applicable checklist gaps are implemented or explicitly resolved.