PerplexitySearchResults 통합
PerplexitySearchResults 통합 (PerplexitySearchResults integration)
LangChain JavaScript로 PerplexitySearchResults 툴과 통합해요.
Perplexity Search API는 실시간으로 grounding된 웹 검색 결과를 반환해요. PerplexitySearchResults는 에이전트가 API를 쿼리하고 검색 결과의 JSON 배열을 받을 수 있게 하는 LangChain 툴 래퍼예요.
개요 (Overview)
통합 세부 정보 (Integration details)
| 클래스 | 패키지 | PY 지원 | 버전 |
|---|---|---|---|
PerplexitySearchResults |
@langchain/perplexity |
✅ |
설정 (Setup)
이 통합은 @langchain/perplexity 패키지에 있어요:
yarn add @langchain/perplexity @langchain/core
pnpm add @langchain/perplexity @langchain/core
자격 증명 (Credentials)
Perplexity API 키를 만들고 PERPLEXITY_API_KEY 환경 변수로 설정하세요:
process.env.PERPLEXITY_API_KEY = "your-api-key";
최고 수준의 관측 가능성을 위해 LangSmith를 설정하는 것도 도움이 돼요 (필수는 아니에요):
process.env.LANGSMITH_TRACING = "true";
process.env.LANGSMITH_API_KEY = "your-api-key";
인스턴스화 (Instantiation)
import { PerplexitySearchResults } from "@langchain/perplexity";
const tool = new PerplexitySearchResults({
maxResults: 5,
// searchDomainFilter: ["wikipedia.org"],
// searchRecencyFilter: "week",
});
생성자 옵션에는 maxResults, country, searchDomainFilter, searchRecencyFilter, searchAfterDate, searchBeforeDate가 있어요. 자세한 내용은 Perplexity Search API 파라미터를 참고하세요.
호출 (Invocation)
직접 호출 (Direct call)
const result = await tool.invoke("Who won the most recent FIFA World Cup?");
console.log(result);
툴은 각각 title, url, snippet, date, last_updated를 갖는 검색 결과의 JSON 인코딩 배열을 반환해요.
에이전트와 함께 사용 (Use with an agent)
import { ChatAnthropic } from "@langchain/anthropic";
import { createReactAgent } from "@langchain/langgraph/prebuilt";
const llm = new ChatAnthropic({ model: "claude-haiku-4-5" });
const agent = createReactAgent({
llm,
tools: [tool],
});
const response = await agent.invoke({
messages: [
{ role: "user", content: "What's the latest news on the Mars Sample Return mission?" },
],
});
API reference
모든 PerplexitySearchResults 기능과 구성에 대한 자세한 문서는 API reference를 참고하세요.
출처: 문서
본문
PerplexitySearchResults는 Perplexity Search API를 감싸는 LangChain 툴로, @langchain/perplexity 패키지에서 제공돼요. maxResults·country·searchDomainFilter·searchRecencyFilter 등 옵션으로 인스턴스화해 직접 호출하거나 createReactAgent 같은 에이전트에 툴로 연결할 수 있어요. API 키는 PERPLEXITY_API_KEY 환경 변수로 설정해야 해요.