> ## 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.

# Langfuse を CometAPI に接続する

> このガイドでは、base URL、API key、model または provider オプションを設定して Langfuse を CometAPI に接続する方法を説明します。

[Langfuse](https://langfuse.com/) は、LLM の可観測性、プロンプト（Prompt）管理、プレイグラウンド、評価ワークフローを提供します。Langfuse Playground や LLM-as-a-Judge の評価から CometAPI モデルを呼び出したい場合は、CometAPI で Langfuse の LLM Connection を設定します。

## 前提条件

* Langfuse Cloud プロジェクト、またはセルフホストされた Langfuse インスタンス
* 有効な API key を持つ CometAPI アカウント — [ダッシュボードで取得](https://www.cometapi.com/console/token)
* [CometAPI Models ページ](/ja/overview/models) から選択した CometAPI model ID が少なくとも 1 つ

## 統合を設定する

<Steps>
  <Step title="Langfuse の LLM connection を作成する">
    Langfuse で **Project Settings** → **LLM Connections** を開きます。LLM API key を追加するフローを開始します。
  </Step>

  <Step title="OpenAI adapter を選択する">
    provider として **OpenAI** を選択します。Langfuse は、OpenAI API スキーマをサポートする model provider に対してこの adapter を使用します。
  </Step>

  <Step title="CometAPI の認証情報を入力する">
    次の値で connection を設定します。

    | Field            | Value                                                        |
    | ---------------- | ------------------------------------------------------------ |
    | API key          | CometAPI の API key                                           |
    | Base URL         | `https://api.cometapi.com/v1`                                |
    | Custom model IDs | [CometAPI Models ページ](/ja/overview/models) の 1 つ以上の model ID |

    Langfuse で base URL フィールドが **Advanced Settings** の下に表示される場合は、connection を保存する前にそのセクションを展開してください。
  </Step>

  <Step title="Playground でテストする">
    Langfuse Playground で、CometAPI の LLM connection と、設定済みの model ID の 1 つを選択します。短いプロンプト（Prompt）を送信して、Langfuse がレスポンスを受け取ることを確認します。
  </Step>
</Steps>

## LLM-as-a-Judge で CometAPI を使う

Langfuse の LLM-as-a-Judge evaluator では、同じ LLM connection を使用できます。evaluator の設定で CometAPI connection を選択し、スコアリング用プロンプト（Prompt）で構造化抽出が必要な場合は、tool calling をサポートする model ID を選択します。

provider オプションは、選択した CometAPI model がそれらのリクエストフィールドをサポートしている場合にのみ使用してください。model の確認には、[CometAPI Models ページ](/ja/overview/models) または `/v1/models` API を使用します。

## トラブルシューティング

<AccordionGroup>
  <Accordion title="model が Langfuse に表示されない">
    LLM connection の custom model IDs リストに、正確な CometAPI model ID を追加してください。Langfuse は、カスタムの OpenAI-compatible provider については、すべての model を自動で検出するわけではありません。
  </Accordion>

  <Accordion title="リクエストで誤った API パスが使用される">
    base URL として `https://api.cometapi.com/v1` を使用してください。Langfuse は、選択した adapter に応じた OpenAI-compatible パスを付加します。
  </Accordion>

  <Accordion title="evaluator の呼び出しが失敗する">
    選択した model が、tool calling や JSON 出力など、evaluator が使用するリクエスト機能をサポートしていることを確認してください。
  </Accordion>
</AccordionGroup>

## 関連リソース

* [Langfuse LLM Connections](https://langfuse.com/docs/administration/llm-connection)
* [CometAPI クイックスタート](/ja/overview/quick-start)
* [CometAPI Models ページ](/ja/overview/models)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/langfuse#howto",
        "name": "Langfuse を CometAPI に接続する",
        "description": "このガイドでは、base URL、API key、model または provider オプションを設定して、Langfuse を CometAPI に接続する方法を説明します。",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-1",
            "position": 1,
            "name": "Langfuse LLM connection を作成する",
            "text": "Langfuse を CometAPI に接続するガイドの「Langfuse LLM connection を作成する」ステップを完了します。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-2",
            "position": 2,
            "name": "OpenAI アダプターを選択する",
            "text": "Langfuse を CometAPI に接続するガイドの「OpenAI アダプターを選択する」ステップを完了します。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-3",
            "position": 3,
            "name": "CometAPI の認証情報を入力する",
            "text": "Langfuse を CometAPI に接続するガイドの「CometAPI の認証情報を入力する」ステップを完了します。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-4",
            "position": 4,
            "name": "Playground でテストする",
            "text": "Langfuse を 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": "Langfuse を CometAPI に接続する",
            "item": "https://apidoc.cometapi.com/integrations/langfuse"
          }
        ]
      }
    ]
    }
    `}
</script>