AI 도구 설정

Coze

Coze에서 생성용 Felo Model API와 검색용 Data API HTTP 도구를 각각 연결합니다.

준비 사항

API 키와 잔액을 준비하세요. Tavily 검색 예제이며 다른 API의 매개변수와 가격은 해당 문서를 확인하세요.

앱 설정

Plugins → Create → Import OpenAPI → Workflow / Agent에서 아래 값을 저장하고 요청을 테스트하세요. 버전에 따라 화면 이름이 다를 수 있습니다.

검색 도구 연결

Data API: Coze plugin → Import OpenAPI → X-API-Key credential → Agent tool / Workflow
Model API: self-hosted Coze Studio → custom OpenAI provider → model selection

OpenAPI 파일을 가져오거나 JSON HTTP POST를 만드세요. 키는 자격 증명에 저장하고 query를 입력으로, results를 다음 단계로 전달하세요.

OpenAPI JSON

Data API 요청

Field	Value
Method	`POST`
URL	`https://openapi.felo.ai/v1/beta/tavily/search`
Authorization	`Bearer YOUR_FELO_API_KEY`
OpenAPI credential	`X-API-Key: YOUR_FELO_API_KEY`
Content-Type	`application/json`
query	`Felo API Platform documentation`
max_results	`3`
Output	`results[].title`, `results[].url`, `results[].content`

{
  "query": "Felo API Platform documentation",
  "max_results": 3
}

export FELO_API_KEY='YOUR_FELO_API_KEY'
curl 'https://openapi.felo.ai/v1/beta/tavily/search' \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "query": "Felo API Platform documentation",
  "max_results": 3
}'

모델 API 연결

모델 목록에서 Model ID를 복사하고 OpenAI 호환 Base URL을 설정하세요. Data API는 별도 HTTP 도구로 설정합니다.

Coze Studio → model configuration → protocol: openai / base_url / api_key / model ID에서 아래 값을 저장하고 요청을 테스트하세요. 버전에 따라 화면 이름이 다를 수 있습니다.

Field	Value
Base URL	`https://openapi.felo.ai/api/v1`
API Key	`YOUR_FELO_API_KEY`
Model ID	`YOUR_MODEL_ID`
HTTP POST	`https://openapi.felo.ai/api/v1/chat/completions`
Output	`choices[0].message.content`

Model ID · Protocols

{
  "model": "YOUR_MODEL_ID",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ],
  "stream": false
}

curl 'https://openapi.felo.ai/api/v1/chat/completions' \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "YOUR_MODEL_ID",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ],
  "stream": false
}'

작동 확인

results의 title, url, content를 확인하고 에이전트에 결과와 출처 URL을 사용하도록 요청하세요. 빈 배열도 정상입니다. 콘솔에서 Felo 사용량을 확인하세요.

문제 해결

401: 키와 Authorization, 402: 잔액, 400: JSON과 query를 확인하세요. 429·5xx는 지연 후 재시도하고 request_id를 보관하세요. 시트는 승인·공유 권한, 실행 환경은 키 설정도 확인하세요.