Skip to content

Validate tutorial: conversational agent #131

Closed

Description

Goal: validate that docs/tutorial-conversational-agent.md works 100% from a clean environment as part of Sprint 5 adoption readiness.

Definition of done:

  • Execute the tutorial end to end exactly as documented.
  • Confirm all commands work without hidden assumptions.
  • Confirm expected AgentOps outputs are produced, including results/report artifacts where applicable.
  • Confirm CI/CD, Azure resources, and Watchdog steps work when the tutorial includes them.
  • Capture evidence and update the tutorial if any step is unclear, broken, or incomplete.

Activity

  1. Dongbumlee commented on May 14, 2026

    @Dongbumlee

    Parking this issue.

    Audit during validation revealed the 'conversational agent' tutorial promises features AgentOps does not implement today:

    Tutorial claim Reality
    extra_fields: [history] config key Schema rejects unknown keys (tests/unit/test_agentops_config.py:155)
    history JSONL column forwarded to agent No code consumes it (grep -rn extra_fields src/agentops/ returns 0 matches)
    Cross-row conversation state orchestrator.py:543 iterates rows independently; each is a fresh invocation
    request_field/response_field overrides, single-turn Q&A scoring Work as documented

    What remains is identical to the basic Foundry agent / HTTP agent tutorials — the dataset shape is the differentiator, not the invocation semantics. Validating the tutorial as a renamed copy of #127/#129 adds little value; reframing it requires a product call on whether AgentOps should support multi-turn (history) and per-row passthrough (extra_fields) at all.

    Resuming after the product direction on conversation-state is decided. Branch fix/issue-131-conversational-agent-validation had no commits and has been discarded clean. Audit notes live in the session plan and can be reconstituted in 5 minutes when this comes back.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions