Cala

Cala

Cala는 AI 에이전트를 위한 검증된 지식 그래프예요. 구조화되고 출처가 인용되며 추적 가능한 사실을 반환합니다—원시 웹 스크레이핑이 아니라요. 모든 답변에는 인용, 신뢰 점수, 엔티티 수준의 출처(provenance)가 포함되어, 감사 가능하고 환각에 강한 검색이 필요한 프로덕션 에이전트에 적합합니다.

출처: 문서

본문

설치

pip install langchain-cala

API 키는 console.cala.ai에서 받으세요.

구성

import os
os.environ["CALA_API_KEY"] = "your-api-key"

또는 키를 직접 전달하세요:

from langchain_cala import CalaRetriever

retriever = CalaRetriever(api_key="your-api-key")

검색기(Retriever)

CalaRetriever는 LangChain의 BaseRetriever 인터페이스를 구현하며 세 가지 모드를 지원합니다:

모드(Mode) 엔드포인트(Endpoint) 사용 시점(Use when)
"search" (기본값) POST /v1/knowledge/search 개방형 NL 질문 — 인용이 포함된 종합된 답변을 반환
"query" POST /v1/knowledge/query 구조화된 점 표기법 조회 — 예: "OpenAI.founded.year"
"entities" GET /v1/entities 더 깊은 질의 전에 이름으로 엔티티 발견 
from langchain_cala import CalaRetriever

retriever = CalaRetriever(api_key="your-api-key")
docs = retriever.invoke("Which EU AI startups raised funding in 2024?")

for doc in docs:
    print(doc.page_content)
    print(doc.metadata)  # includes 'verified', 'source', 'explainability'

구조화된 질의(Structured query)

retriever = CalaRetriever(api_key="your-api-key", mode="query")
docs = retriever.invoke("Mistral.founded.year")

엔티티 발견(Entity discovery)

retriever = CalaRetriever(api_key="your-api-key", mode="entities")
docs = retriever.invoke("Factorial HR")

RAG 체인에서

from langchain_cala import CalaRetriever
from langchain_core.output_parsers import StrOutputParser
from langchain_core.prompts import ChatPromptTemplate
from langchain_core.runnables import RunnablePassthrough
from langchain_openai import ChatOpenAI

retriever = CalaRetriever(api_key="your-api-key")

prompt = ChatPromptTemplate.from_template(
    "Answer the question based only on the following context:\n\n{context}\n\nQuestion: {question}"
)

chain = (
    {"context": retriever, "question": RunnablePassthrough()}
    | prompt
    | ChatOpenAI()
    | StrOutputParser()
)

chain.invoke("Who are the key players in European AI infrastructure?")

주요 파라미터(Key parameters)

파라미터(Parameter) 타입(Type) 기본값(Default) 설명(Description)
api_key SecretStr $CALA_API_KEY 당신의 Cala API 키
mode str "search" "search", "query", "entities" 중 하나
k int 5 반환할 최대 문서 수
timeout int 30 HTTP 요청 타임아웃(초)

Cala를 선택하는 이유(Why Cala)

웹 검색 검색기와 달리 Cala는 전체 출처 추적이 가능한 검증된 엔티티 데이터를 반환합니다. 응답의 모든 문서에는 verified 메타데이터 필드와 인용 체인이 포함되어 있어, 고위험 AI 배포를 위한 EU AI Act 제13조 설명 가능성(explainability) 요구 사항을 충족합니다.

더 알아보기 (Learn more)