커넥터

커넥터 추가하기

GitHub 조직 소유자나 개인 계정의 소유자만 커넥터를 관리할 수 있습니다. 워크스페이스 설정 → 멤버에서 이들은 GitHub 조직 소유자 또는 계정 소유자로 표시됩니다.

유료 요금제가 종료된 경우를 포함해, 무료 요금제에서는 검토와 작업에서 저장된 커넥터를 사용하지 않습니다. 커넥터는 제거만 할 수 있습니다.

1. 워크스페이스 설정 → 커넥터를 열고 커넥터 추가를 선택하세요.
2. 이름, 서버의 HTTPS 엔드포인트, 서버에 필요한 요청 헤더를 입력한 다음 도구 불러오기를 선택하세요.
3. 허용할 도구, 저장소, 커넥터를 사용할 범위를 선택하세요.
4. 커넥터 저장을 선택하세요. 그 이후에 시작된 검토와 작업부터 이 커넥터를 사용할 수 있습니다.

커넥터를 편집할 때 헤더 값을 비워 두면 저장된 값이 유지됩니다. 엔드포인트를 변경하면 모든 값을 다시 입력하세요.

도구

읽기 전용 도구에는 서버가 읽기 전용으로 표시한 도구가 나열됩니다. 서버가 표시하지 않은 도구를 포함해 그 밖의 모든 도구는 기타 도구에 있습니다. 도구를 처음 불러오면 읽기 전용 도구만 허용됩니다.

에이전트는 허용된 도구만 호출할 수 있으며, 도구가 도움이 되는 시점은 에이전트가 판단합니다. 서버의 도구가 바뀌면 도구 다시 불러오기를 선택하세요.

커넥터가 사용되는 곳

커넥터는 모든 저장소에 적용하거나 선택한 저장소에만 적용할 수 있습니다. 여러 저장소에 걸친 작업은 그중 어느 저장소의 커넥터든 사용할 수 있습니다.

기본적으로 커넥터는 비공개 저장소에서 쓰기 권한이 있는 사람의 변경에만 사용됩니다. 다음 경우에는 검토나 작업에서 커넥터를 제외합니다.

• 저장소가 공개되어 있거나, 작업이 공개 저장소를 변경할 수 있는 경우
• 풀 리퀘스트가 포크에서 온 경우
• 풀 리퀘스트 작성자에게 저장소 쓰기 권한이 없는 경우

공개 저장소와 포크 포함은 공개 문서처럼 누구나 볼 수 있는 데이터를 다루는 커넥터에만 선택하세요. 검토나 작업 페이지에 제외된 커넥터와 그 이유가 표시됩니다.

커넥터 호출

검토나 작업 페이지에는 커넥터 호출마다 커넥터, 도구, 실행 시각, 소요 시간, 실패 여부가 나열됩니다. HeyDeer는 보내거나 반환된 내용을 보관하지 않습니다.

도구 호출과 그 결과로 반환되는 텍스트는 작업에 포함되므로 크레딧 사용량에 더해집니다. 커넥터를 호출한 후 검토가 실패하면 크레딧은 반환되지 않습니다. 크레딧 사용 방식을 참고하세요.

개인정보 보호와 신뢰

에이전트는 헤더 값을 볼 수 없습니다. 에이전트의 요청이 밖으로 나갈 때 HeyDeer의 샌드박스가 헤더 값을 추가합니다.

요청에는 코드와 작업 맥락이 포함될 수 있으며, 서버 운영자는 자체 정책에 따라 이를 처리합니다. 읽기 전용 도구도 비공개 데이터를 반환할 수 있으므로 신뢰할 수 있는 서비스만 연결하고, 읽기 전용 데이터베이스 역할처럼 꼭 필요한 접근 권한만 가진 자격 증명을 사용하며, 필요한 도구만 허용하세요. 보안을 참고하세요.

HeyDeer가 커넥터의 도구를 불러오지 못하면 문제 해결을 참고하세요.