CodeDocsSearchTool¶
实验性
我们仍在改进工具,因此未来可能会出现意外行为或变化。
描述¶
CodeDocsSearchTool 是一个强大的 RAG(检索增强生成)工具,专为在代码文档中进行语义搜索而设计。它使用户能够高效地在代码文档中查找特定信息或主题。通过在初始化时提供 docs_url,工具将搜索范围缩小到特定的文档站点。或者,如果没有特定的 docs_url,它会在执行过程中已知或发现的广泛代码文档中进行搜索,使其适用于各种文档搜索需求。
安装¶
要开始使用 CodeDocsSearchTool,首先通过 pip 安装 crewai_tools 包:
示例¶
按照以下方式使用 CodeDocsSearchTool 在代码文档中进行搜索:
from crewai_tools import CodeDocsSearchTool
# 如果已知 URL 或在执行过程中发现 URL,搜索任何代码文档内容:
tool = CodeDocsSearchTool()
# 或者
# 通过提供其 URL 特定地将搜索重点放在给定的文档站点上:
tool = CodeDocsSearchTool(docs_url='https://docs.example.com/reference')
参数¶
docs_url:可选。指定要搜索的代码文档的 URL。在工具初始化时提供此参数会将搜索重点放在指定的文档内容上。
自定义模型和嵌入¶
默认情况下,工具使用 OpenAI 进行嵌入和总结。要自定义模型,可以使用如下配置字典:
tool = CodeDocsSearchTool(
config=dict(
llm=dict(
provider="ollama", # 或 google, openai, anthropic, llama2, ...
config=dict(
model="llama2",
# temperature=0.5,
# top_p=1,
# stream=true,
),
),
embedder=dict(
provider="google", # 或 openai, ollama, ...
config=dict(
model="models/embedding-001",
task_type="retrieval_document",
# title="Embeddings",
),
),
)
)