Skip to main content
Agent는 외부 제공자(OpenAI, Anthropic, Google) 모델과 Nora 관리 모델 티어로 돕니다. Agent가 부르는 제공자마다 워크스페이스 수준 API 키가 필요합니다.

​
키가 사는 곳

  • 워크스페이스 스코프 키는 사용자별이 아니라 워크스페이스별입니다.
  • 저장 시 암호화 UI나 API로 절대 안 돌아옵니다. 앱이 키를 다시 못 읽습니다.
  • 워크스페이스별 사용량 귀속 키를 워크스페이스별로 두면 제공자 대시보드에서 비용이 깔끔하게 나뉩니다.

​
키 더하기

Settings → Models → Providers → Add key 입니다.
  1. 제공자를 고릅니다(OpenAI, Anthropic, Google, …).
  2. 키를 붙입니다. 입력이 가려집니다.
  3. 저장합니다.
또는 CLI 로요.
CLI 세부는 nora providers를 참고하세요.

​
Nora가 지원하는 제공자

  • OpenAI GPT 모델.
  • Anthropic Claude 모델.
  • Google Gemini 모델.
  • Nora managed Nora가 호스팅하는 모델(외부 키가 필요 없습니다. Nora가 결제합니다).
제공자가 계속 늘어납니다. 앱의 providers 목록이 지금 목록을 보여줍니다.

​
키 로테이션

새 값으로 키를 다시 더합니다. 이전 키가 한 번에 바뀝니다.
  • 새 실행이 곧바로 새 키를 씁니다.
  • 돌던 실행은 이전 키에서 끝냅니다(네트워크가 안정될 때까지 최대 1분).
몇 분에 걸쳐 auth 실패를 보며 확인합니다.

​
키 삭제

키를 지웁니다. 그 제공자를 쓰는 Agent는 새 키를 정할 때까지 다음 실행이 실패합니다.

​
Provider 준비 점검

Flow를 배포하기 전, 모든 모델에 provider 키가 있는지 확인합니다.
이런 표를 찍습니다.
CI가 이 점검으로 배포를 막을 수 있습니다.

​
Provider 키와 Nora 관리 모델

  • Provider 키 여러분이 제공자에게 직접, 그들 미터로 결제합니다.
  • Nora 관리 Nora가 모델을 호스팅하고 Nora 인보이스로 결제합니다. 결제가 더 간단하고 가끔 더 쌉니다.
**--set-model**로 Agent 블록마다 고릅니다(nora agents 참고). 마음껏 섞으세요. 한 Flow가 같은 실행에서 provider 모델과 관리 모델을 함께 쓸 수 있습니다.

​
요율 제한과 쿼터

Provider 요율 제한이 걸립니다. Agent가 부하에서 429를 받으면 이렇게 하세요.
  • Provider 티어를 올립니다(OpenAI의 Tier 4, Anthropic의 Enterprise 등).
  • Agent 별 폴백 모델을 더합니다(nora agents update --set-model 참고). Agent가 실패하면 매끄럽게 넘어갑니다.
  • 의도별로 라우팅합니다. 싼 의도는 싼 모델, 어려운 의도는 프리미엄 모델로요.
Nora는 provider 위에 자체 요율 제한을 더하지 않습니다.

​
비용 대시보드

Provider 비용은 provider 자체 대시보드(OpenAI, Anthropic, Google)에 뜹니다. Nora의 결제 화면은 Nora 플랫폼 비용을 다룹니다. 결제 개요를 참고하세요. 키가 워크스페이스별이라 provider 대시보드에서 워크스페이스별 비용이 쉽게 나뉩니다.

​
보안

  • 키가 워크스페이스별 키로 암호화되어 저장됩니다.
  • 로테이션은 즉시입니다.
  • 삭제는 영구입니다(키가 안 남습니다).
  • 모든 추가·로테이션·삭제가 감사됩니다.

​
관련