동물원 코드 API 설정

Zoo Code의 공식 첫 번째 공급자 튜토리얼에서는 시작 화면 흐름을 다룹니다. VS Code 활동 표시줄에서 Zoo Code를 열고 공급자를 선택하고 키를 입력하고 모델을 선택한 다음 초기화를 완료합니다. TokenHub는 공식 사전 설정이 아니므로 이 가이드에서는 자사 TokenHub 통합을 주장하지 않고 현재 OpenAI Compatible 필드를 사용합니다.

처음 실행 시 시작 화면에서 시작

1. VS Code 활동 표시줄에서 Zoo Code 아이콘을 클릭합니다.
2. 시작 화면에서 LLM 공급자를 선택합니다.
3. 공식 OpenAI 계정이 필요한 옵션이 아닌 OpenAI Compatible를 선택하세요.
4. 아래 필드를 TokenHub 값으로 채우고 초기화를 완료하세요.

초기 설정 후 기어부터 시작

1. Zoo Code 사이드바를 엽니다.
2. 기어를 클릭하여 Settings를 엽니다.
3. API Provider에서 OpenAI Compatible를 선택합니다.
4. 입력:
   • Base URL: https://us-api.tokenhub.com/v1
   • API Key: TokenHub API 키
   • Model ID: TokenHub 모델 카탈로그의 전체 ID
   • Context Window Size: 모델 사양을 확인한 후 설정하십시오.
5. 저장한 다음 작업 바닥글이 실제로 이 공급자 프로필을 사용하는지 확인하세요.

Zoo Code의 현재 OpenAI 호환 공급자는 채팅 완료를 호출합니다. 기본 URL는 /v1에서 중지되어야 합니다. 전체 /chat/completions 경로를 입력하지 마십시오.

Zoo Code 에이전트 동작 확인

1. 작업을 만들고 "현재 파일을 수정하지 않고 설명하세요."라고 질문하세요.
2. TokenHub 로그에서 /v1/chat/completions 및 프로필의 모델 ID를 확인하세요.
3. 모델이 구조화된 도구 호출을 반환하는지 확인하려면 작은 파일 편집을 요청하세요.

Zoo Code의 모델 선택 지침은 도구 단계 전반에 걸쳐 지침 따르기, 형식 준수 및 컨텍스트 유지를 강조합니다. 모델이 일반적인 질문에 답변했지만 파일을 편집할 수 없는 경우 Base URL를 반복적으로 변경하는 대신 더 강력한 도구 호출 모델로 전환하세요.

실제 공급자 필드 문제 해결

• 404: Base URL가 /v1에서 끝나고 아직 /chat/completions를 포함하지 않는지 확인합니다.
• 401: API 키를 다시 붙여넣고 현재 작업이 TokenHub 프로필을 선택했는지 확인하세요.
• 모델 오류: Model ID는 TokenHub에서 허용하는 전체 ID여야 합니다.
• 채팅은 작동하지만 도구는 작동하지 않습니다. 모델이 Zoo Code의 에이전트 하네스에 적합하지 않을 수 있습니다.
• 저장된 변경 사항은 이전 공급자를 사용합니다. 새 작업을 만들고 해당 바닥글에 표시된 공급자/모델을 다시 확인하세요.

공식 참고자료

• Zoo Code: 첫 번째 공급자 연결
• Zoo Code OpenAI 호환 현장 보고서
• Zoo Code 저장소