Skip to content

docs: add FAQ section#1776

Open
meichuanyi wants to merge 1 commit into
trpc-group:mainfrom
meichuanyi:docs-faq-1778459031
Open

docs: add FAQ section#1776
meichuanyi wants to merge 1 commit into
trpc-group:mainfrom
meichuanyi:docs-faq-1778459031

Conversation

@meichuanyi
Copy link
Copy Markdown

Adds a comprehensive FAQ section to help users quickly understand tRPC-Agent-Go:

  • What is tRPC-Agent-Go: Powerful Go framework for intelligent agent systems
  • Comparison: Differences from LangChain
  • GraphAgent: Type-safe graph workflows (LangGraph equivalent for Go)
  • Installation: go get command
  • LLM providers: OpenAI/Anthropic/Azure/local models
  • Memory system: Persistent memory with search
  • Agent Skills: Reusable SKILL.md workflows
  • AG-UI: Agent-User Interaction
  • A2A: Agent-to-Agent interoperability
  • Help resources: Documentation/Go Reference/GitHub Issues

This FAQ aims to reduce user confusion and improve the onboarding experience for Go developers.

…ation, LLM providers, memory system, Agent Skills, AG-UI, A2A, and help resources
@meichuanyi meichuanyi requested a review from sandyskies as a code owner May 11, 2026 00:24
@github-actions
Copy link
Copy Markdown


Thank you for your submission, we really appreciate it. Like many open-source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution. You can sign the CLA by just posting a Pull Request Comment same as the below format.


I have read the CLA Document and I hereby sign the CLA


You can retrigger this bot by commenting recheck in this Pull Request. Posted by the CLA Assistant Lite bot.

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 11, 2026

Review Change Stack

📝 Walkthrough

Change Overview

This PR adds a comprehensive FAQ section to the README.md file, containing 10 frequently asked questions designed to help users quickly understand tRPC-Agent-Go's capabilities and key differentiators. The new section covers:

  • Framework purpose: What tRPC-Agent-Go is and its core value proposition
  • Competitive positioning: Explicit comparison with LangChain highlighting Go-native focus, production-readiness, telemetry/tracing, and GraphAgent capabilities
  • Core concepts: GraphAgent (type-safe workflows with conditional routing), Agent Skills (SKILL.md-based reusable workflows), memory system (persistent storage with search), AG-UI (user interaction), and A2A (agent-to-agent interoperability)
  • Practical guidance: Installation command (go get trpc.group/trpc-go/trpc-agent-go), supported LLM providers (OpenAI, Anthropic, Azure, local models, custom)
  • Support resources: Direct links to documentation, Go reference, and GitHub issues

Scope: 69 lines of documentation content added to README.md. No code changes, no new exported entities, no behavioral modifications.

Compatibility and Behavioral Risks

Risk Level: None

  • Documentation-only change: No code modifications, APIs, or functional implementations affected
  • No breaking changes: Existing functionality remains unchanged
  • Backward compatible: Purely additive to user-facing documentation
  • No build/runtime impact: README is not included in compiled artifacts

Recommended Validation Steps

  1. Content accuracy verification:

    • Confirm all LLM providers listed (OpenAI, Anthropic, Azure, local models) are actually supported in the codebase
    • Verify GraphAgent comparison to LangGraph is technically accurate
    • Validate that all resource links (documentation, Go pkg.dev reference, GitHub Issues URL) are correct and accessible
  2. Consistency checks:

    • Ensure FAQ content aligns with existing README sections (Features, Examples, Quick Start)
    • Cross-reference Agent Skills description against actual SKILL.md specification
    • Verify memory system description matches implementation in memory service code
  3. User experience review:

    • Confirm FAQ placement (after Key Features, before Examples) improves discoverability
    • Assess whether information density is appropriate for quick onboarding vs. detailed guides
    • Validate that LangChain comparison is balanced and accurate without being dismissive

中文

变更概览

本PR向README.md文件添加了一个全面的FAQ(常见问题)部分,包含10个常见问题,旨在帮助用户快速理解tRPC-Agent-Go的功能和核心差异。新增章节涵盖:

  • 框架用途:tRPC-Agent-Go是什么及其核心价值主张
  • 竞争定位:与LangChain的显式对比,突出Go原生、生产就绪、内置遥测/追踪和GraphAgent能力
  • 核心概念:GraphAgent(具有条件路由的类型安全工作流)、Agent Skills(基于SKILL.md的可复用工作流)、内存系统(支持搜索的持久存储)、AG-UI(用户交互)和A2A(代理间互操作性)
  • 实用指南:安装命令(go get trpc.group/trpc-go/trpc-agent-go)、支持的LLM提供商(OpenAI、Anthropic、Azure、本地模型、自定义提供商)
  • 支持资源:文档、Go参考和GitHub Issues的直接链接

范围:向README.md添加了69行文档内容。无代码变更,无新导出实体,无行为修改。

兼容性和行为风险

风险等级:无

  • 仅文档变更:无代码修改、API变更或功能实现影响
  • 无破坏性变更:现有功能保持不变
  • 向后兼容:纯粹的文档补充
  • 无构建/运行时影响:README不包含在编译产物中

推荐验证步骤

  1. 内容准确性验证

    • 确认所有列出的LLM提供商(OpenAI、Anthropic、Azure、本地模型)在代码库中实际得到支持
    • 验证GraphAgent与LangGraph的对比在技术上是准确的
    • 验证所有资源链接(文档、Go pkg.dev参考、GitHub Issues URL)正确且可访问
  2. 一致性检查

    • 确保FAQ内容与现有README部分(功能、示例、快速开始)保持一致
    • 交叉参考Agent Skills描述与实际SKILL.md规范
    • 验证内存系统描述与内存服务代码实现相符
  3. 用户体验审查

    • 确认FAQ放置位置(在关键功能之后、示例之前)是否提高了可发现性
    • 评估信息密度是否适合快速入门而非详细指南
    • 验证LangChain对比是否客观准确且不失尊重

Walkthrough

README.md receives a new FAQ section addressing core user questions: what tRPC-Agent-Go is, how it differs from LangChain, GraphAgent purpose, installation via go get, supported LLM providers, memory system design, Agent Skills location, AG-UI capabilities, A2A support, and help resources.

Changes

FAQ Documentation

Layer / File(s) Summary
FAQ Section
README.md
New FAQ section with Q&A subsections covering project overview, framework comparisons, GraphAgent details, installation instructions, supported LLM providers, memory system, Agent Skills reference, AG-UI introduction, A2A interoperability, and links to documentation and support channels.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title 'docs: add FAQ section' directly and concisely describes the main change - adding a FAQ section to documentation.
Description check ✅ Passed The description comprehensively explains the FAQ content and purpose, directly related to the changeset which adds a FAQ section to README.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Tip

💬 Introducing Slack Agent: The best way for teams to turn conversations into code.

Slack Agent is built on CodeRabbit's deep understanding of your code, so your team can collaborate across the entire SDLC without losing context.

  • Generate code and open pull requests
  • Plan features and break down work
  • Investigate incidents and troubleshoot customer tickets together
  • Automate recurring tasks and respond to alerts with triggers
  • Summarize progress and report instantly

Built for teams:

  • Shared memory across your entire org—no repeating context
  • Per-thread sandboxes to safely plan and execute work
  • Governance built-in—scoped access, auditability, and budget controls

One agent for your entire SDLC. Right inside Slack.

👉 Get started


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@README.md`:
- Around line 737-805: The README.zh_CN.md is missing the FAQ section present in
README.md (the block from the "## FAQ" heading through the "How do I get help?"
item); add a translated Chinese version of that entire FAQ block into
README.zh_CN.md, preserving the same structure (## FAQ and the same question
headings such as "What is tRPC-Agent-Go?", "How does tRPC-Agent-Go differ from
LangChain?", "How do I install tRPC-Agent-Go?", "What LLM providers are
supported?", "What is the memory system?", "What are Agent Skills?", "What is
AG-UI?", "What is A2A?", and "How do I get help?") and translate the content and
links appropriately, and update any table of contents or index in
README.zh_CN.md if one exists to include the new FAQ section.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 6187b8e8-084b-448f-a851-ee3536e5453d

📥 Commits

Reviewing files that changed from the base of the PR and between a5463fa and 5740158.

📒 Files selected for processing (1)
  • README.md

Comment thread README.md
Comment on lines +737 to +805
## FAQ

### What is tRPC-Agent-Go?

tRPC-Agent-Go is a powerful Go framework for building intelligent agent systems. It transforms how you create AI applications by providing autonomous agents that think, remember, collaborate, and act with unprecedented ease.

### How does tRPC-Agent-Go differ from LangChain?

- **tRPC-Agent-Go**: Go-native framework, high performance, production-ready with telemetry/tracing, GraphAgent (type-safe workflows), Agent Skills (SKILL.md), built-in memory service
- **LangChain**: Python-first, broader ecosystem, more third-party integrations

### What is GraphAgent?

GraphAgent provides type-safe graph workflows with multi-conditional routing, functionally equivalent to LangGraph but for Go:
- Chain-based workflows
- Parallel execution
- Conditional routing
- Type-safe state management

### How do I install tRPC-Agent-Go?

```bash
go get trpc.group/trpc-go/trpc-agent-go
```

### What LLM providers are supported?

tRPC-Agent-Go supports multiple LLM providers:
- OpenAI
- Anthropic
- Azure OpenAI
- Local models
- Custom providers via model interface

### What is the memory system?

The memory system provides:
- Persistent memory with search
- Long-term state management
- Contextual awareness across sessions
- Memory service managed at runner level

### What are Agent Skills?

Agent Skills are reusable workflows defined in `SKILL.md` files:
- Safe execution environment
- Reusable across agents
- Human-readable workflow definitions

### What is AG-UI?

AG-UI (Agent-User Interaction) provides:
- UI integration for agents
- User interaction capabilities
- Visual workflow management

### What is A2A?

A2A (Agent-to-Agent) provides:
- Agent interoperability
- Communication between agents
- Multi-agent collaboration protocols

### How do I get help?

- **Documentation**: https://trpc-group.github.io/trpc-agent-go/
- **Go Reference**: https://pkg.go.dev/trpc.group/trpc-go/trpc-agent-go
- **GitHub Issues**: https://github.com/trpc-group/trpc-agent-go/issues

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Description: Check if README.zh_CN.md exists and contains FAQ section

# Check if Chinese README exists
if [ -f "README.zh_CN.md" ]; then
    echo "=== README.zh_CN.md found ==="
    
    # Search for FAQ section
    echo "=== Checking for FAQ section ==="
    rg -n "FAQ|常见问题" README.zh_CN.md || echo "No FAQ section found"
    
    # Count lines to see if it was updated
    wc -l README.zh_CN.md
else
    echo "README.zh_CN.md not found"
fi

Repository: trpc-group/trpc-agent-go

Length of output: 172


Add FAQ section to README.zh_CN.md for consistency with README.md.

The FAQ section (lines 737-805 in README.md) is missing from README.zh_CN.md. Since the repository maintains bilingual documentation, this section should be translated and added to the Chinese version to keep both versions consistent.

中文

向 README.zh_CN.md 添加 FAQ 部分以与 README.md 保持一致。

README.md 中的 FAQ 部分(第 737-805 行)在 README.zh_CN.md 中缺失。由于仓库维护双语文档,此部分应翻译后添加到中文版本,保持两个版本的一致性。

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@README.md` around lines 737 - 805, The README.zh_CN.md is missing the FAQ
section present in README.md (the block from the "## FAQ" heading through the
"How do I get help?" item); add a translated Chinese version of that entire FAQ
block into README.zh_CN.md, preserving the same structure (## FAQ and the same
question headings such as "What is tRPC-Agent-Go?", "How does tRPC-Agent-Go
differ from LangChain?", "How do I install tRPC-Agent-Go?", "What LLM providers
are supported?", "What is the memory system?", "What are Agent Skills?", "What
is AG-UI?", "What is A2A?", and "How do I get help?") and translate the content
and links appropriately, and update any table of contents or index in
README.zh_CN.md if one exists to include the new FAQ section.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant