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

# Coze APIの統合

> Coze を LangBot と統合。Coze のボットやエージェントを Discord・Telegram・WeChat 等に接続。

このドキュメントでは、CozeプラットフォームからTokenとBot IDを取得し、LangBotパイプライン設定に入力する方法を説明します。

## 1. TokenとBot IDの取得

1. Cozeプラットフォームにログインし、開発者コンソールに入ります。
   <img src="https://mintcdn.com/langbot/OB26CZsqXqbSrW_A/images/zh/deploy/pipelines/coze/coze07.png?fit=max&auto=format&n=OB26CZsqXqbSrW_A&q=85&s=783d8b03bc12258aa6d80c4cb799d757" alt="Coze Application API Key" width="1908" height="899" data-path="images/zh/deploy/pipelines/coze/coze07.png" />

2. 「API管理」でトークンを作成してコピーします。
   <img src="https://mintcdn.com/langbot/OB26CZsqXqbSrW_A/images/zh/deploy/pipelines/coze/coze06.png?fit=max&auto=format&n=OB26CZsqXqbSrW_A&q=85&s=8f88f48ed677714c4d3f2b40be0c8863" alt="Coze Application API Key" width="1920" height="898" data-path="images/zh/deploy/pipelines/coze/coze06.png" />

<Info>
  Coze認証では、coze.cnは「サービスIDと認証情報」を通じた長期認証をサポートしていますが、coze.comはPersonal Access Tokenのみを提供しています。
</Info>

3. プロジェクト開発セクションから自分のエージェントを選択します(または新しいエージェントを作成します)。取得したIDが`bot_id`です。
   <img src="https://mintcdn.com/langbot/OB26CZsqXqbSrW_A/images/zh/deploy/pipelines/coze/coze05.png?fit=max&auto=format&n=OB26CZsqXqbSrW_A&q=85&s=c7524f00232de11f24dd4f2a679a0c53" alt="Coze bot_id" width="1920" height="980" data-path="images/zh/deploy/pipelines/coze/coze05.png" />

* エージェントを公開する際は、必ずAPIオプションを選択してください
  <img src="https://mintcdn.com/langbot/OB26CZsqXqbSrW_A/images/zh/deploy/pipelines/coze/coze04.png?fit=max&auto=format&n=OB26CZsqXqbSrW_A&q=85&s=aba3a9c097b156ba5d078c4ccdad0bf1" alt="Coze Application API Key" width="1920" height="855" data-path="images/zh/deploy/pipelines/coze/coze04.png" />

以下の2つの情報を安全に保管してください:

* **token**: Cozeプラットフォームで生成されたトークン
* **bot\_id**: Bot ID

## 2. LangBotでの設定入力

1. LangBot WebUIを開き、パイプラインの設定ページに移動します(または新しいパイプラインを作成してその設定ページに入ります)

2. 「AI機能」で、ランナーとして`Coze API`を選択します

3. ランナーの設定項目に入力します:

   * **token**: CozeプラットフォームからコピーしたAPIトークンを貼り付けます
   * **bot\_id**: 対応するBot IDを貼り付けます
   * 使用しているCozeサイトに応じて`API Base URL`を選択してください: coze.cnの場合は`https://api.coze.cn`を入力してください; coze.comの場合は`https://api.coze.com`を入力してください

   <img src="https://mintcdn.com/langbot/OB26CZsqXqbSrW_A/images/zh/deploy/pipelines/coze/coze08.png?fit=max&auto=format&n=OB26CZsqXqbSrW_A&q=85&s=4a9b19b80a7ebb85e61f58b5319b00cb" alt="パイプライン設定" width="1097" height="751" data-path="images/zh/deploy/pipelines/coze/coze08.png" />

4. 「保存」をクリックして設定を完了します

完了すると、このパイプライン内でCozeエージェントを呼び出して対話処理ができます

## よくある質問(FAQ)

* **保存が失敗するか、呼び出しがエラーを返す**: トークンとbot\_idが正しく、余分なスペースが含まれていないことを確認してください
* **`Coze API`を選択できない**: 現在のバージョンがこのランナーをサポートしているか確認してください。まだサポートされていない場合は、Cozeランナーを含むバージョンにアップグレードしてください

一般的なパイプライン設定の詳細については、[対話パイプライン設定の変更](/ja/usage/pipelines/readme)を参照してください
