How hotba318/ai_agent_task works
Group 3 is a paper-research workflow comprising retrieval, common-reference analysis, and grounded report writing. Users can run retrieval independently, then analyze the stored papers’ shared citations and provide analysis/evidence inputs to the Writer. Retrieval searches, ranks, downloads, parses, and stores papers; the Writer produces Markdown with citation/numeric checks and optional model review. The README documents these capabilities; unsampled modules are included where their role is documented or named in the source index, but their internal call details are not inferred.
Main entry points: services.py Analysis services · retrieval/agent.py Retrieval agent · writer/agent.py Writer agent · references/agent.py Reference analyzer
Components 30
Paper Retrieval
- Retrieval CLI
group3/cli.py - Retrieval agent
group3/agents/retrieval/agent.py - Search providers
group3/agents/retrieval/search.py - arXiv client
group3/agents/retrieval/arxiv_client.py - DataCite client
group3/agents/retrieval/datacite_client.py - Search planner
group3/agents/retrieval/planner.py - Relevance ranker
group3/agents/retrieval/ranker.py - Document fetcher
group3/agents/retrieval/fetcher.py - HTTP downloader
group3/agents/retrieval/downloader.py - Document parser
group3/agents/retrieval/parser.py - Paper store
group3/agents/retrieval/storage.py
Common References
- Analysis CLI
group3/analysis_cli.py - Analysis services
group3/services.py - Reference analyzer
group3/agents/references/agent.py - Citation matcher
group3/agents/references/matcher.py
Grounded Writing
- Writer agent
group3/agents/writer/agent.py - Draft planner
group3/agents/writer/planner.py - Grounded draft
group3/agents/writer/draft.py - Claim validator
group3/agents/writer/validator.py - Markdown renderer
group3/agents/writer/renderer.py - Revision state
group3/agents/writer/state.py
Shared Contracts
- Structured LLM client
group3/common/llm.py - Retrieval contracts
group3/common/schemas.py - Analysis contracts
group3/common/analysis_schemas.py - Configuration
group3/common/config.py - Agent interfaces
group3/common/interfaces.py
Other components
- Researcher
- Paper sources
- GROBID service
- Groq API
Connections 39
- Researcher → Retrieval CLI: starts retrieval
README.md - Retrieval CLI → Retrieval agent: runs
group3/cli.py - Retrieval agent → Search planner: plans searches
group3/agents/retrieval/agent.py - Retrieval agent → Document fetcher: fetches papers
group3/agents/retrieval/agent.py - Retrieval agent → Configuration: uses settings
group3/agents/retrieval/agent.py - Search planner → Relevance ranker: ranks candidates
group3/agents/retrieval/planner.py - Search planner → Structured LLM client: requests decisions
group3/agents/retrieval/planner.py - Search providers → arXiv client: queries
- Search providers → DataCite client: queries
- Document fetcher → HTTP downloader: downloads
group3/agents/retrieval/fetcher.py - Document fetcher → Document parser: parses documents
group3/agents/retrieval/fetcher.py - Document fetcher → Paper store: stores papers
group3/agents/retrieval/fetcher.py - HTTP downloader → Paper sources: requests documents
- Document parser → GROBID service: parses PDFs
- Retrieval agent → Retrieval contracts: uses contracts
group3/agents/retrieval/agent.py - Researcher → Analysis CLI: starts analysis
README.md - Analysis CLI → Analysis services: dispatches
group3/analysis_cli.py - Analysis services → Reference analyzer: runs analysis
group3/services.py - Analysis services → Paper store: selects stored papers
group3/services.py - Reference analyzer → Paper store: loads papers
group3/agents/references/agent.py - Reference analyzer → Citation matcher: matches citations
group3/agents/references/agent.py - Reference analyzer → Analysis contracts: returns results
group3/agents/references/agent.py - Analysis CLI → Analysis services: dispatches writing
README.md - Analysis services → Writer agent: runs or revises
group3/services.py - Analysis services → Draft planner: selects planner
group3/services.py - Analysis services → Configuration: uses settings
group3/services.py - Writer agent → Draft planner: plans prose
group3/agents/writer/agent.py - Writer agent → Claim validator: validates claims
group3/agents/writer/agent.py - Writer agent → Markdown renderer: renders report
group3/agents/writer/agent.py - Writer agent → Revision state: tracks revisions
group3/agents/writer/agent.py - Draft planner → Grounded draft: builds draft
group3/agents/writer/planner.py - Draft planner → Claim validator: checks draft
group3/agents/writer/planner.py - Draft planner → Structured LLM client: requests generation
group3/agents/writer/planner.py - Markdown renderer → Grounded draft: renders draft
group3/agents/writer/renderer.py - Markdown renderer → Claim validator: checks output
group3/agents/writer/renderer.py - Claim validator → Reference analyzer: recomputes citations
group3/agents/writer/validator.py - Structured LLM client → Groq API: sends completions
group3/common/llm.py - Writer agent → Analysis contracts: uses contracts
group3/agents/writer/agent.py - Retrieval agent → Agent interfaces: uses interfaces
group3/agents/retrieval/agent.py