Add working Haystack example, wire into CI, and update docs (#1230)

* examples: add Haystack 2.x OpenAI example; wire into examples CI; fix docs links

Co-Authored-By: Alex <[email protected]>

* examples(haystack): fix import path for OpenAIGenerator (Haystack 2.x) and use named argument

Co-Authored-By: Alex <[email protected]>

* examples(haystack): add post-run validation via agentops.validate_trace_spans and print summary

Co-Authored-By: Alex <[email protected]>

* examples(haystack): start a trace and validate against it; end with end_trace to ensure session URL and proper validation

Co-Authored-By: Alex <[email protected]>

---------

Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-authored-by: Alex <[email protected]>

Author: devin-ai-integration[bot]

.github/workflows/examples-integration-test.yml

@@ -105,6 +105,9 @@ jobs:
 
           # DSPy examples
           - { path: 'examples/dspy/dspy_calculator.py', name: 'DSPy ReAct Agent' }
+
+          # Haystack examples
+          - { path: 'examples/haystack/haystack_example.py', name: 'Haystack OpenAI' }
           # Add more examples as needed
 
 
@@ -189,4 +192,4 @@ jobs:
           echo "✅ All examples passed!" >> $GITHUB_STEP_SUMMARY
         else
           echo "❌ Some examples failed. Check the logs above." >> $GITHUB_STEP_SUMMARY
-        fi 
+        fi  

docs/v1/integrations/haystack.mdx

@@ -69,10 +69,9 @@ AgentOps makes monitoring your Haystack agents seamless. Haystack, much like Aut
 
 ## Full Examples
 
-You can refer to the following examples -
+You can refer to the following example -
 
-- [Philosopher Agent](https://github.com/AgentOps-AI/agentops/blob/main/examples/haystack_examples/haystack_anthropic_example.ipynb)
-- [Mathematician Agent](https://github.com/AgentOps-AI/agentops/blob/main/examples/haystack_examples/haystack_openai_example.ipynb)
+- [Simple Haystack example (OpenAI)](https://github.com/AgentOps-AI/agentops/blob/main/examples/haystack/haystack_example.py)
 
 
 <script type="module" src="/scripts/github_stars.js"></script>

examples/haystack/haystack_example.py

@@ -0,0 +1,34 @@
+import os
+
+import agentops
+from haystack.components.generators.openai import OpenAIGenerator
+
+
+def main():
+    agentops.init(os.getenv("AGENTOPS_API_KEY"))
+
+    tracer = agentops.start_trace(
+        trace_name="Haystack OpenAI Example",
+        tags=["haystack", "openai", "agentops-example"],
+    )
+
+    prompt = "In one sentence, what is AgentOps?"
+    generator = OpenAIGenerator(model="gpt-4o-mini")
+    result = generator.run(prompt=prompt)
+    replies = result.get("replies") or []
+    print("Haystack reply:", replies[0] if replies else "<no reply>")
+
+    print("\n" + "=" * 50)
+    print("Now let's verify that our LLM calls were tracked properly...")
+    try:
+        validation_result = agentops.validate_trace_spans(trace_context=tracer)
+        agentops.print_validation_summary(validation_result)
+    except agentops.ValidationError as e:
+        print(f"\n❌ Error validating spans: {e}")
+        raise
+
+    agentops.end_trace(tracer, end_state="Success")
+
+
+if __name__ == "__main__":
+    main()

examples/haystack/requirements.txt

@@ -0,0 +1,2 @@
+haystack-ai>=2.0.0
+openai>=1.0.0