Skip to main content
在本笔记本中,我们将学习 Reddit 搜索工具的使用方法。 首先,请使用以下命令安装 praw:
pip install -qU  praw
然后,您需要配置相应的 API 密钥和环境变量。您需要创建一个 Reddit 用户账号并获取凭证。请前往 www.reddit.com 注册 Reddit 用户账号。 然后前往 www.reddit.com/prefs/apps 创建一个应用程序以获取凭证。 创建应用后,您将获得 client_id 和 client_secret。现在,将这两个字符串分别粘贴到 client_id 和 client_secret 变量中。 注意:user_agent 可以填写任意字符串。
client_id = ""
client_secret = ""
user_agent = ""
from langchain_community.tools.reddit_search.tool import RedditSearchRun
from langchain_community.utilities.reddit_search import RedditSearchAPIWrapper

search = RedditSearchRun(
    api_wrapper=RedditSearchAPIWrapper(
        reddit_client_id=client_id,
        reddit_client_secret=client_secret,
        reddit_user_agent=user_agent,
    )
)
您可以设置查询参数,例如要查询的 subreddit、返回的帖子数量、结果排序方式等。
from langchain_community.tools.reddit_search.tool import RedditSearchSchema

search_params = RedditSearchSchema(
    query="beginner", sort="new", time_filter="week", subreddit="python", limit="2"
)
最后,运行搜索并获取结果:
result = search.run(tool_input=search_params.dict())
print(result)
以下是打印结果的示例。 注意:您可能会获得不同的输出,具体取决于 subreddit 中的最新帖子,但格式应该类似。
Searching r/python found 2 posts: Post Title: ‘Setup Github Copilot in Visual Studio Code’ User: Feisty-Recording-715 Subreddit: r/Python: Text body: ��️ This tutorial is perfect for beginners looking to strengthen their understanding of version control or for experienced developers seeking a quick reference for GitHub setup in Visual Studio Code. 🎓 By the end of this video, you’ll be equipped with the skills to confidently manage your codebase, collaborate with others, and contribute to open-source projects on GitHub. Video link: youtu.be/IdT1BhrSfdo?si=mV7xVpiyuhlD8Zrw Your feedback is welcome Post URL: www.reddit.com/r/Python/comments/1823wr7/setup_github_copilot_in_visual_studio_code/ Post Category: N/A. Score: 0 Post Title: ‘A Chinese Checkers game made with pygame and PySide6, with custom bots support’ User: HenryChess Subreddit: r/Python: Text body: GitHub link: github.com/henrychess/pygame-chinese-checkers I’m not sure if this counts as beginner or intermediate. I think I’m still in the beginner zone, so I flair it as beginner. This is a Chinese Checkers (aka Sternhalma) game for 2 to 3 players. The bots I wrote are easy to beat, as they’re mainly for debugging the game logic part of the code. However, you can write up your own custom bots. There is a guide at the github page. Post URL: www.reddit.com/r/Python/comments/181xq0u/a_chinese_checkers_game_made_with_pygame_and/ Post Category: N/A. Score: 1

在 Agent 链中使用该工具

Reddit 搜索功能也可作为多输入工具使用。在本示例中,我们参考文档中的现有代码,使用 ChatOpenAI 创建一个带记忆的 agent 链。该 agent 链能够从 Reddit 拉取信息,并利用这些帖子来回应后续输入。 要运行此示例,请添加您的 Reddit API 访问信息,并从 OpenAI API 获取 OpenAI 密钥。
# Adapted code from /docs/modules/agents/how_to/sharedmemory_for_tools

from langchain.agents import AgentExecutor, StructuredChatAgent
from langchain_classic.chains import LLMChain
from langchain.memory import ConversationBufferMemory, ReadOnlySharedMemory
from langchain_community.tools.reddit_search.tool import RedditSearchRun
from langchain_community.utilities.reddit_search import RedditSearchAPIWrapper
from langchain_core.prompts import PromptTemplate
from langchain_openai import ChatOpenAI

# Provide keys for Reddit
client_id = ""
client_secret = ""
user_agent = ""
# Provide key for OpenAI
openai_api_key = ""

template = """This is a conversation between a human and a bot:

{chat_history}

Write a summary of the conversation for {input}:
"""

prompt = PromptTemplate(input_variables=["input", "chat_history"], template=template)
memory = ConversationBufferMemory(memory_key="chat_history")

prefix = """Have a conversation with a human, answering the following questions as best you can. You have access to the following tools:"""
suffix = """Begin!"

{chat_history}
Question: {input}
{agent_scratchpad}"""

tools = [
    RedditSearchRun(
        api_wrapper=RedditSearchAPIWrapper(
            reddit_client_id=client_id,
            reddit_client_secret=client_secret,
            reddit_user_agent=user_agent,
        )
    )
]

prompt = StructuredChatAgent.create_prompt(
    prefix=prefix,
    tools=tools,
    suffix=suffix,
    input_variables=["input", "chat_history", "agent_scratchpad"],
)

llm = ChatOpenAI(temperature=0, openai_api_key=openai_api_key)

llm_chain = LLMChain(llm=llm, prompt=prompt)
agent = StructuredChatAgent(llm_chain=llm_chain, verbose=True, tools=tools)
agent_chain = AgentExecutor.from_agent_and_tools(
    agent=agent, verbose=True, memory=memory, tools=tools
)

# Answering the first prompt requires usage of the Reddit search tool.
agent_chain.run(input="What is the newest post on r/langchain for the week?")
# Answering the subsequent prompt uses memory.
agent_chain.run(input="Who is the author of the post?")