> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Langflow를 CometAPI에 연결하기

> 이 가이드를 사용해 base URL, API key, model 또는 provider 옵션을 설정하여 Langflow를 CometAPI에 연결하세요.

[Langflow](https://www.langflow.org/)는 에이전트와 RAG 워크플로를 구축하기 위한 시각적 프레임워크입니다. Langflow에는 OpenAI 호환 엔드포인트를 통해 CometAPI 언어 모델을 호출하는 CometAPI 컴포넌트가 포함되어 있습니다.

## 사전 요구 사항

* Langflow Desktop, Langflow Cloud 또는 자체 호스팅 Langflow 인스턴스
* 활성 API key가 있는 CometAPI 계정 — [대시보드에서 발급받기](https://www.cometapi.com/console/token)
* [CometAPI Models 페이지](/ko/overview/models)의 model ID

## 통합 구성하기

<Steps>
  <Step title="CometAPI 컴포넌트 추가">
    Langflow 캔버스에서 컴포넌트 메뉴를 엽니다. **CometAPI**를 검색한 다음, CometAPI 텍스트 생성 컴포넌트를 플로에 추가합니다.
  </Step>

  <Step title="CometAPI API key 입력">
    CometAPI 컴포넌트를 선택합니다. 컴포넌트 검사 패널의 API key 필드에 CometAPI API key를 입력합니다.
  </Step>

  <Step title="model ID 선택">
    model ID를 [CometAPI Models 페이지](/ko/overview/models)의 값으로 설정합니다. API key를 입력한 뒤 컴포넌트가 모델을 가져올 수 있다면, 모델 메뉴에서 model ID를 선택합니다.
  </Step>

  <Step title="채팅 입력과 출력 연결">
    최소 테스트 플로를 위해 **Chat Input** 및 **Chat Output** 컴포넌트를 추가합니다. **Chat Input**을 CometAPI 컴포넌트 입력에 연결한 다음, CometAPI 출력을 **Chat Output**에 연결합니다.
  </Step>

  <Step title="Playground에서 테스트">
    Playground를 열고 짧은 메시지를 보냅니다. 채팅 응답이 성공적으로 반환되면 Langflow가 CometAPI를 호출하고 있음을 확인할 수 있습니다.
  </Step>
</Steps>

## 더 큰 플로 안에서 CometAPI 사용하기

다른 Langflow 컴포넌트에 LLM 입력이 필요할 때는 CometAPI 컴포넌트의 출력 타입을 **Language Model**로 변경하세요. 이는 Agent, Prompt Template, Smart Transform 플로에서 유용합니다.

직접 채팅의 경우 기본 모델 응답 출력을 그대로 유지하고 Chat Output 컴포넌트에 연결하세요.

## Python에서 CometAPI 플로 실행하기

Playground에서 플로를 테스트한 후에는 Python에서 동일한 Langflow 플로를 호출할 수 있습니다. Python 코드는 Langflow 서버를 호출합니다. 요청을 CometAPI로 직접 보내지는 않습니다. CometAPI API key와 model ID는 Langflow 내부의 CometAPI 컴포넌트에 유지하세요.

REST API 예시는 flow ID 또는 endpoint name으로 채팅 입력을 전송합니다:

```python theme={null}
import os

import requests

langflow_url = os.environ.get("LANGFLOW_URL", "http://localhost:7860")
langflow_api_key = os.environ["LANGFLOW_API_KEY"]
flow_id = os.environ["LANGFLOW_FLOW_ID"]

response = requests.post(
    f"{langflow_url}/api/v1/run/{flow_id}",
    headers={
        "x-api-key": langflow_api_key,
        "Content-Type": "application/json",
    },
    json={
        "input_value": "Hello from CometAPI",
        "input_type": "chat",
        "output_type": "chat",
    },
    timeout=60,
)
response.raise_for_status()
print(response.json())
```

Langflow Python SDK를 사용하는 프로젝트의 경우 `langflow-sdk`를 설치하고 `Client.run()`을 통해 동일한 플로를 호출하세요:

```python theme={null}
from langflow_sdk import Client

client = Client("http://localhost:7860", api_key="<LANGFLOW_API_KEY>")
response = client.run("FLOW_ID", input_value="Hello from CometAPI")
print(response.first_text_output())
```

`FLOW_ID`를 Langflow의 flow ID 또는 endpoint name으로 바꾸세요. `<LANGFLOW_API_KEY>`를 Langflow API key로 바꾸세요. 이 값은 CometAPI API key와 다릅니다.

## 문제 해결

<AccordionGroup>
  <Accordion title="CometAPI 컴포넌트가 없습니다">
    CometAPI 번들이 포함된 버전으로 Langflow를 업데이트하세요. 배포 환경에서 일부 컴포넌트가 숨겨져 있다면, 번들 설정을 확인하거나 language model 컴포넌트 아래에서 검색하세요.
  </Accordion>

  <Accordion title="모델 목록이 로드되지 않습니다">
    CometAPI API 키가 유효한지, 그리고 계정에 선택한 모델에 대한 접근 권한이 있는지 확인하세요. model ID를 수동으로 입력할 수도 있습니다.
  </Accordion>

  <Accordion title="플로우는 실행되지만 오류가 반환됩니다">
    model ID가 CometAPI와 정확히 일치하는지, 그리고 플로우 입력이 CometAPI 컴포넌트 입력에 연결되어 있는지 확인하세요.
  </Accordion>
</AccordionGroup>

## 관련 리소스

* [Langflow CometAPI 번들](https://docs.langflow.org/bundles-cometapi)
* [Langflow API 플로우 트리거](https://docs.langflow.org/concepts-publish)
* [langflow-sdk 패키지](https://pypi.org/project/langflow-sdk/)
* [CometAPI 빠른 시작](/ko/overview/quick-start)
* [CometAPI 모델 페이지](/ko/overview/models)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/langflow#howto",
        "name": "Langflow를 CometAPI에 연결하기",
        "description": "이 가이드를 사용해 base URL, API 키, 그리고 모델 또는 provider 옵션을 설정하여 Langflow를 CometAPI에 연결하세요.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langflow#step-1",
            "position": 1,
            "name": "CometAPI 컴포넌트 추가",
            "text": "Langflow를 CometAPI에 연결하기 가이드에서 CometAPI 컴포넌트 추가 단계를 완료하세요."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langflow#step-2",
            "position": 2,
            "name": "CometAPI API 키 입력",
            "text": "Langflow를 CometAPI에 연결하기 가이드에서 CometAPI API 키 입력 단계를 완료하세요."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langflow#step-3",
            "position": 3,
            "name": "model ID 선택",
            "text": "Langflow를 CometAPI에 연결하기 가이드에서 model ID 선택 단계를 완료하세요."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langflow#step-4",
            "position": 4,
            "name": "채팅 입력 및 출력 연결",
            "text": "Langflow를 CometAPI에 연결하기 가이드에서 채팅 입력 및 출력 연결 단계를 완료하세요."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langflow#step-5",
            "position": 5,
            "name": "Playground에서 테스트",
            "text": "Langflow를 CometAPI에 연결하기 가이드에서 Playground에서 테스트 단계를 완료하세요."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI 문서",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "연동",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Langflow를 CometAPI에 연결하기",
            "item": "https://apidoc.cometapi.com/integrations/langflow"
          }
        ]
      }
    ]
    }
    `}
</script>