fix comments

Author: minimAluminiumalism

README-zh.md

@@ -42,6 +42,7 @@ LoongSuite Python Agent 同时也是上游 [OTel Python Agent](https://github.co
 | [LiteLLM](https://github.com/BerriAI/litellm) | [GUIDE](instrumentation-loongsuite/loongsuite-instrumentation-litellm/README.md) | [PyPI](https://pypi.org/project/loongsuite-instrumentation-litellm/) |
 | [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk) | [GUIDE](instrumentation-loongsuite/loongsuite-instrumentation-mcp/README.md) | in dev |
 | [Mem0](https://github.com/mem0ai/mem0) | [GUIDE](instrumentation-loongsuite/loongsuite-instrumentation-mem0/README.md) | [PyPI](https://pypi.org/project/loongsuite-instrumentation-mem0/) |
+| [OpenAI Agents SDK](https://github.com/openai/openai-agents-python) | [GUIDE](instrumentation-loongsuite/loongsuite-instrumentation-openai-agents/README.rst) | in dev |
 
 **发行版与辅助组件：**
 

README.md

@@ -42,6 +42,7 @@ Source tree: [`instrumentation-loongsuite/`](instrumentation-loongsuite).
 | [LiteLLM](https://github.com/BerriAI/litellm) | [GUIDE](instrumentation-loongsuite/loongsuite-instrumentation-litellm/README.md) | [PyPI](https://pypi.org/project/loongsuite-instrumentation-litellm/) |
 | [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk) | [GUIDE](instrumentation-loongsuite/loongsuite-instrumentation-mcp/README.md) | in dev |
 | [Mem0](https://github.com/mem0ai/mem0) | [GUIDE](instrumentation-loongsuite/loongsuite-instrumentation-mem0/README.md) | [PyPI](https://pypi.org/project/loongsuite-instrumentation-mem0/) |
+| [OpenAI Agents SDK](https://github.com/openai/openai-agents-python) | [GUIDE](instrumentation-loongsuite/loongsuite-instrumentation-openai-agents/README.rst) | in dev |
 
 **Distro and helpers:**
 

instrumentation-loongsuite/loongsuite-instrumentation-openai-agents/pyproject.toml

@@ -11,6 +11,7 @@ license = "Apache-2.0"
 requires-python = ">=3.10"
 authors = [
   { name = "OpenTelemetry Authors", email = "cncf-opentelemetry-contributors@lists.cncf.io" },
+  { name = "minimAluminiumalism", email = "caixuesen@outlook.com" },
 ]
 classifiers = [
   "Development Status :: 4 - Beta",

instrumentation-loongsuite/loongsuite-instrumentation-openai-agents/tests/test_processor.py

@@ -26,6 +26,7 @@
     GenerationSpanData,
     GuardrailSpanData,
     HandoffSpanData,
+    ResponseSpanData,
 )
 
 from opentelemetry.instrumentation.openai_agents._processor import (
@@ -380,3 +381,91 @@ def test_processor_does_not_throw(self, setup):
         processor.on_span_end(None)
         processor.on_trace_start(None)
         processor.on_trace_end(None)
+
+
+class _FakeUsage:
+    def __init__(self, input_tokens=100, output_tokens=50):
+        self.input_tokens = input_tokens
+        self.output_tokens = output_tokens
+
+
+class _FakeResponse:
+    def __init__(self, model="gpt-4o", id="resp-001", usage=None):
+        self.model = model
+        self.id = id
+        self.usage = usage or _FakeUsage()
+
+
+class TestResponseSpan:
+    def test_response_creates_chat_span(self, setup):
+        processor, exporter = setup
+        trace = FakeTrace()
+        processor.on_trace_start(trace)
+
+        data = ResponseSpanData(response=_FakeResponse())
+        span = FakeSpan(
+            span_data=data,
+            span_id="resp_span_001",
+            trace_id=trace.trace_id,
+        )
+        processor.on_span_start(span)
+        processor.on_span_end(span)
+        processor.on_trace_end(trace)
+
+        spans = exporter.get_finished_spans()
+        chat_spans = [s for s in spans if "chat" in s.name]
+        assert len(chat_spans) == 1
+        attrs = dict(chat_spans[0].attributes)
+        assert attrs["gen_ai.operation.name"] == "chat"
+        assert attrs["gen_ai.system"] == "openai"
+        assert attrs["gen_ai.request.model"] == "gpt-4o"
+
+    def test_response_extracts_usage(self, setup):
+        processor, exporter = setup
+        trace = FakeTrace()
+        processor.on_trace_start(trace)
+
+        resp = _FakeResponse(
+            model="gpt-4o-mini",
+            usage=_FakeUsage(input_tokens=200, output_tokens=80),
+        )
+        data = ResponseSpanData(response=resp)
+        span = FakeSpan(
+            span_data=data,
+            span_id="resp_span_002",
+            trace_id=trace.trace_id,
+        )
+        processor.on_span_start(span)
+        processor.on_span_end(span)
+        processor.on_trace_end(trace)
+
+        spans = exporter.get_finished_spans()
+        chat_spans = [s for s in spans if "chat" in s.name]
+        assert len(chat_spans) == 1
+        attrs = dict(chat_spans[0].attributes)
+        assert attrs["gen_ai.response.model"] == "gpt-4o-mini"
+        assert attrs["gen_ai.response.id"] == "resp-001"
+        assert attrs["gen_ai.usage.input_tokens"] == 200
+        assert attrs["gen_ai.usage.output_tokens"] == 80
+
+    def test_response_captures_input_content(self, setup):
+        processor, exporter = setup
+        trace = FakeTrace()
+        processor.on_trace_start(trace)
+
+        data = ResponseSpanData(response=_FakeResponse())
+        data.input = [{"role": "user", "content": "Hello"}]
+        span = FakeSpan(
+            span_data=data,
+            span_id="resp_span_003",
+            trace_id=trace.trace_id,
+        )
+        processor.on_span_start(span)
+        processor.on_span_end(span)
+        processor.on_trace_end(trace)
+
+        spans = exporter.get_finished_spans()
+        chat_spans = [s for s in spans if "chat" in s.name]
+        assert len(chat_spans) == 1
+        attrs = dict(chat_spans[0].attributes)
+        assert "gen_ai.input.messages" in attrs