> ## 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/) 是一个用于构建 Agent 和 RAG 工作流的可视化框架。Langflow 包含一个 CometAPI 组件，可通过与 OpenAI 兼容的端点调用 CometAPI 语言模型。

## 前提条件

* Langflow Desktop、Langflow Cloud，或自托管的 Langflow 实例
* 一个拥有有效 API key 的 CometAPI 账户——[在控制台中获取你的 key](https://www.cometapi.com/console/token)
* 来自 [CometAPI Models 页面](/zh-Hans/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 页面](/zh-Hans/overview/models) 中的某个值。如果该组件在你输入 API key 后可以获取模型，请从 model 菜单中选择 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 组件">
    将 Langflow 更新到包含 CometAPI bundle 的版本。如果你的部署隐藏了某些组件，请检查 bundle 设置，或在语言模型组件下搜索。
  </Accordion>

  <Accordion title="模型列表无法加载">
    确认 CometAPI API key 有效，并且账户有权访问所选模型。你也可以手动输入 model ID。
  </Accordion>

  <Accordion title="流程运行了但返回错误">
    检查 model ID 是否与 CometAPI 完全一致，并确认流程输入已连接到 CometAPI 组件输入。
  </Accordion>
</AccordionGroup>

## 相关资源

* [Langflow CometAPI bundle](https://docs.langflow.org/bundles-cometapi)
* [Langflow API flow trigger](https://docs.langflow.org/concepts-publish)
* [langflow-sdk package](https://pypi.org/project/langflow-sdk/)
* [CometAPI 快速开始](/zh-Hans/overview/quick-start)
* [CometAPI Models 页面](/zh-Hans/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 key 以及模型或提供商选项，将 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 key",
            "text": "完成“将 Langflow 连接到 CometAPI”指南中的“输入你的 CometAPI API key”步骤。"
          },
          {
            "@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>