Overview
Integration details
| Class | Package | Local | Serializable | JS support | Downloads | Version |
|---|---|---|---|---|---|---|
| GraphTool | langchain-writer | ❌ | ❌ | ❌ | ||
| TranslationTool | langchain-writer | ❌ | ❌ | ❌ | ||
| WebSearchTool | langchain-writer | ❌ | ❌ | ❌ |
Features
ChatWriter는 여러 tool 유형을 지원합니다: function, graph, translation, web_search.
중요한 제한사항: 한 번에 하나의 WRITER tool(translation, graph, web_search, llm, image, vision)만 사용할 수 있습니다. 여러 WRITER tool을 결합할 수는 없지만, 하나의 WRITER tool과 여러 custom function tool을 함께 사용할 수 있습니다.
Function
Function은 가장 일반적인 tool 유형으로, LLM이 외부 API를 호출하고, 데이터베이스에서 데이터를 가져오며, 일반적으로 원하는 모든 외부 작업을 수행할 수 있게 합니다. 추가 정보는 WRITER의 tool calling docs를 참조하세요.Graph
Graph tool은 WRITER의 Knowledge Graph를 사용하며, 이는 그래프 기반 retrieval-augmented generation(RAG) 시스템입니다. 이 tool을 사용할 때 개발자는 특정 Knowledge Graph를 참조하는 graph ID를 제공합니다. 그러면 모델이 이 그래프를 사용하여 관련 정보를 찾고 프롬프트의 질문에 대한 정확한 답변을 생성합니다. 이를 통해 모델이 대화 중에 사용자 정의 지식 베이스에 액세스하고 활용할 수 있습니다. 자세한 내용은 WRITER의 Knowledge Graph API docs를 참조하세요.
Translation
translation tool을 사용하면 Palmyra 모델과의 대화 중에 텍스트를 번역할 수 있습니다. Palmyra X 모델은 번역 작업을 수행할 수 있지만, 이러한 작업에 최적화되어 있지 않으며 올바른 프롬프팅 없이는 제대로 작동하지 않을 수 있습니다. 자세한 내용은 WRITER의 translation API docs를 참조하세요.Web Search
web search tool을 사용하면 Palmyra 모델과의 대화 중에 웹에서 최신 정보를 검색할 수 있습니다. Palmyra 모델은 광범위한 지식을 가지고 있지만 최신 정보나 실시간 데이터에 액세스하지 못할 수 있습니다. web search tool을 사용하면 AI 어시스턴트가 웹에서 최신 정보, 뉴스 및 사실을 찾을 수 있습니다. 자세한 내용은 WRITER의 web search API docs를 참조하세요.Setup
WRITER AI Studio에 가입하여 API key를 생성하세요(Quickstart 참조). 그런 다음WRITER_API_KEY 환경 변수를 설정하세요:
Usage
graph 또는 function tool을ChatWriter에 바인딩할 수 있습니다.
Graph Tools
graph tool을 바인딩하려면 먼저 소스로 사용할graph_ids로 GraphTool 인스턴스를 생성하고 초기화하세요:
Translation Tools
translation tool을 사용하면 Palmyra 모델과의 대화 중에 텍스트를 번역할 수 있습니다. Palmyra X 모델은 번역 작업을 수행할 수 있지만, 이러한 작업에 최적화되어 있지 않으며 올바른 프롬프팅 없이는 제대로 작동하지 않을 수 있습니다. translation tool을 사용하려면 내장된TranslationTool을 import하고 초기화하세요:
Web Search Tools
web search tool을 사용하면 Palmyra 모델과의 대화 중에 웹에서 최신 정보를 검색할 수 있습니다. Palmyra 모델은 광범위한 지식을 가지고 있지만 최신 정보나 실시간 데이터에 액세스하지 못할 수 있습니다. web search tool을 사용하면 AI 어시스턴트가 웹에서 최신 정보, 뉴스 및 사실을 찾을 수 있습니다. web search tool을 사용하려면 내장된WebSearchTool을 import하고 초기화하세요:
Instantiation
Binding tools
중요 참고사항: WRITER는 한 번에 하나의 WRITER tool(translation, graph, web_search, llm, image, vision)만 바인딩할 수 있습니다. 여러 WRITER tool을 동시에 바인딩할 수 없습니다. 그러나 하나의 WRITER tool과 함께 여러 custom function tool을 바인딩할 수 있습니다.Invocation
모델은 모든 모드(streaming/non-streaming, sync/async)에서 호출 중에 자동으로 tool을 선택합니다.GraphTool의 경우 모델이 원격으로 호출하고 graph_data 키 아래의 additional_kwargs에 사용 정보를 반환합니다:
content 속성에는 최종 응답이 포함됩니다:
Chaining
WRITER Graph tool은 다른 tool과 다르게 작동합니다. 사용될 때 WRITER 서버가 자동으로 Knowledge Graph 호출 및 RAG를 사용한 응답 생성을 처리합니다. 이러한 자동화된 서버 측 처리로 인해GraphTool을 독립적으로 호출하거나 LangChain chain의 일부로 사용할 수 없습니다. 위의 예제에서 보여준 것처럼 GraphTool을 ChatWriter 인스턴스와 직접 사용해야 합니다.
API reference
모든GraphTool 기능 및 구성에 대한 자세한 문서는 API reference를 참조하세요.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.