Cloudflare Workers AI
이 예제에서는 Cloudflare Workers AI를 사용하여 키를 생성합니다.
Cloudflare Workers AI는 Discourse AI에서 **임베딩 제공자(embeddings provider)**로 사용되며(예: 의미론적 검색 및 RAG), LLM 제공자로 사용되지 않습니다.
참고: Workers AI는 무료 및 유료 Cloudflare 플랜 모두에서 사용할 수 있습니다. 사용량 기반 과금이 적용될 수 있습니다. 최신 정보는 여기에서 확인하세요.
플랫폼은 항상 변화하므로 이 가이드가 프로세스의 100%를 반영하지 못할 수 있습니다.
API 키 생성
- Cloudflare에 로그인합니다. 문서의 지시에 따라 API 키와 Account ID를 가져오세요.
- API 키를 생성하고 Account ID를 기록하세요.
- 키가 생성되면 안전하고 보안이 철저한 곳에 저장하고 복사하세요.
Discourse AI에서 API 키 사용
Cloudflare Workers AI 자격 증명은 이제 플러그인 사이트 설정이 아닌 AI Secrets 및 AI Embeddings 관리자 페이지를 통해 구성됩니다.
- 관리자 → 플러그인 → Discourse AI → AI Secrets(
/admin/plugins/discourse-ai/ai-secrets)로 이동합니다. - Cloudflare API 토큰을 사용하여 새로운 시크릿을 생성합니다.
- 관리자 → 플러그인 → Discourse AI → AI Embeddings(
/admin/plugins/discourse-ai/ai-embeddings)로 이동합니다. - 임베딩 정의를 생성하거나 편집하고 제공자로 Cloudflare를 선택합니다.
- URL을 Account ID가 포함된 Cloudflare Workers AI 엔드포인트로 설정합니다. 예:
https://api.cloudflare.com/client/v4/accounts/YOUR_ACCOUNT_ID/ai/run/@cf/baai/bge-large-en-v1.5 - 2단계에서 생성한 AI Secret을 선택합니다.
ai_cloudflare_workers_api_token및ai_cloudflare_workers_account_id는 이제 숨겨져 있으며 비추천(deprecated) 상태입니다. 기존 구성은 자동으로 새로운 Embedding Definitions 및 AI Secrets 시스템으로 마이그레이션되었습니다.