kubeflow / kubeflow/docs-agent

Feat: Ingest GitHub Issue Comments into RAG pipeline

Open
#9 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
42
Forks
111
Avg merge
6d 23m
Merged PRs (30d)
2

Description

Feature: Ingest GitHub Issue Comments into RAG pipeline

Summary

Currently, the RAG ingestion pipeline indexes GitHub issue bodies (see Issues ingestion component). However, the most valuable troubleshooting information and workarounds are typically found in issue comments.

This issue proposes adding a new Kubeflow Pipelines component to ingest GitHub Issue comments and attach them to the issue content for indexing.

Motivation

Indexing only issue title/body limits retrieval quality. With comments ingestion, the assistant can answer:

  • "What workaround exists for error X?"
  • "What did maintainers recommend in issue Y?"
  • "Is this fixed? Which version?"
Proposed Solution

Add a new KFP component:

download_github_issue_comments

A component that:

  • Takes a JSONL dataset of issues (output of download_github_issues)
  • Fetches comments for each issue using GitHub REST API:
    GET /repos/{owner}/{repo}/issues/{issue_number}/comments
  • Appends comments to the issue content (including comment author and timestamp)
  • Outputs JSONL in the same schema for compatibility with chunk_and_embed
Pipeline Flow
download_github_issues (existing/new)
             ↓
download_github_issue_comments (new)
             ↓
chunk_and_embed (existing)
             ↓
store_milvus (existing)
Acceptance Criteria
  • Comments are ingested and appended to issue content
  • PRs are still skipped
  • Output remains JSONL and is compatible with existing embedding + Milvus steps
  • Handles pagination and rate limits gracefully

/cc @kubeflow/docs-agent-maintainers

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by tracing the existing download_github_issues output and the input expected by chunk_and_embed. Define the new download_github_issue_comments component around the GitHub comments endpoint, then verify that issue comments are appended, pull requests remain excluded, pagination and rate limits are handled, and the resulting JSONL still reaches the embedding and Milvus steps.

Written by the indexing model from the issue text.

Assessment

Tech stack
github, python
Domain
ai, data
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
52/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.