为了配置 Python 环境以便使用 Coze 工作流 API 进行开发，需要完成以下几个关键步骤： ### 安装必要的 Python 库 首先，确保安装了 `requests` 和 `PyJWT` 以及 `cryptography` 包，因为这些是与 Coze API 交互所必需的。可以通过以下命令安装： ```bash pip install requests PyJWT cryptography ``` ### 设置认证信息 在调用 Coze 工作流 API 之前，需要准备好必要的认证信息，包括： - **API URL**: Coze 提供的工作流运行接口地址，如 `https://api.coze.cn/v1/workflow/run`。 - **Authorization Token**: 用于身份验证的 Bearer Token，格式为 `Bearer <your_token>`。 - **私钥与公钥指纹**: 如果使用 JWT 生成会话令牌，则需要提供 Coze App 的私钥和公钥指纹。 ### 编写调用 Coze 工作流的代码 以下是一个使用 `requests` 调用 Coze 工作流 API 的示例代码： ```python import requests import json # API URL url = 'https://api.coze.cn/v1/workflow/run' # Headers headers = { 'Authorization': 'Bearer pat_l0jv6QE****', # 替换为真实的 token 'Content-Type': 'application/json' } # 请求数据 data = { "workflow_id": "7451****", # 替换为实际的 workflow_id "parameters": { # 你的工作流的输入 "input": "你好" } } # 发送 POST 请求 response = requests.post(url, headers=headers, data=json.dumps(data)) # 输出响应结果 print(response.status_code) print(response.json()) # 如果返回的是 JSON 数据 ``` ### 生成 JWT 会话令牌（可选） 如果需要使用 JWT 生成会话令牌以确保会话隔离，可以参考以下代码片段： ```python import sys import time import uuid import jwt # 替换为你的实际 Coze App 私钥 signing_key = '''-----BEGIN PRIVATE KEY----- xxxxxxxxxxxxxxxxxx -----END PRIVATE KEY-----''' payload = { 'iat': int(time.time()), 'exp': int(time.time()) + 600, "jti": str(uuid.uuid4()), 'aud': 'api.coze.cn', 'iss': '1127900106117', # 替换为你的实际 Coze App ID 'session_name': '用户的唯一标识' # session_name 参数很重要，虽然不是必填的，但建议作为必填项 } headers = { 'kid': '_v0VjcMlLdQc3tRTD3jC5Xz29TUnKQOhtuD5k-gpyf4' # 替换为你的实际 Coze App 公钥指纹 } # 创建 JWT encoded_jwt = jwt.encode(payload, signing_key, algorithm='RS256', headers=headers) # 输出生成的 JWT print(f"JWT: {encoded_jwt}") ``` ### 配置环境变量（可选） 为了提高安全性，建议将敏感信息（如 `Authorization Token`、`私钥`、`公钥指纹` 等）存储在环境变量中，而不是硬编码在代码中。可以使用 `os.environ` 来获取这些值： ```python import os auth_token = os.getenv('COZE_AUTH_TOKEN') private_key = os.getenv('COZE_PRIVATE_KEY') public_key_fingerprint = os.getenv('COZE_PUBLIC_KEY_FINGERPRINT') app_id = os.getenv('COZE_APP_ID') ``` 然后在代码中使用这些变量代替硬编码值。 ### 测试 API 调用 完成上述配置后，运行代码以测试是否能够成功调用 Coze 工作流 API。如果一切正常，应该会收到一个包含状态码和 JSON 数据的响应。 ### 注意事项 - **错误处理**: 在实际开发中，务必添加适当的错误处理逻辑，例如检查网络连接、处理超时、捕获异常等。 - **安全性**: 确保所有敏感信息（如 Token、私钥等）都得到了妥善保护，避免泄露。 - **调试**: 使用日志记录功能可以帮助更好地调试和监控 API 调用过程。 通过以上步骤，Python 环境将被正确配置，以便使用 Coze 工作流 API 进行开发[^2]。