Team Info 툴킷
Team Info 툴킷을 사용하면 에이전트가 현재 프로젝트에 할당된 팀의 멤버를 조회할 수 있습니다: 총 멤버 수, 또는 이름, 이메일, 사용자 id로 검색. API 키가 없으며 로그인된 사용자의 세션과 프로젝트의 팀 설정을 사용합니다.
에이전드 Toolkits 탭에 추가하고, 프로젝트에 팀이 할당되어 있는지 확인한 다음, 성격 프롬프트에서 @로 도구를 참조하세요.
전제 조건
- 편집할 수 있는 에이전트
- Project Settings → Project Configs → Project Team에서 팀이 선택되어 있어야 하는 프로젝트
- 에이전트가 프로젝트 컨텍스트에서 실행되어야 함
설정
- 프로젝트를 엽니다 → Settings → Project Configs.
- Project Team에서 팀을 선택하고 저장합니다.
- 에이전트를 엽니다 → Toolkits → Team Info 추가.
- 저장하고 멤버 수 또는 이름/이메일 검색으로 테스트합니다.
사용 가능한 도구
| 도구 | 설명 |
|---|---|
| Get Team Member Count | 프로젝트에 할당된 팀의 멤버 수를 반환합니다. |
| Search Team Members | 부분적인 이름, 이메일, 사용자 id로 멤버를 검색합니다(대소문자 무시). 한도 1–50 (기본값 10). |
검색 결과는 사용자 레코드에 존재할 경우 이름, 이메일, 부서, 회사, 마지막 로그인, 태그, 메타데이터 같은 필드를 포함할 수 있습니다.
사용 사례
- "이 팀에 몇 명이 있나요?"에 답하기
- 프로젝트에 초대하기 전에 부분적인 이름으로 팀원의 이메일 찾기
- 채팅에서 언급된 이름이 누구인지 확인하기
팁
- 범위는 프로젝트에 할당된 팀만입니다 — 플랫폼 전체가 아닙니다.
- 검색은 사용자 id, 이메일, 이름과 일치합니다(모든 메타데이터 필드에 대한 자유 텍스트가 아님).
- 결과에는 개인 데이터(이메일, 이름)가 포함됩니다. 에이전트의 대상에게 적절할 때만 이 툴킷을 활성화하세요.
- 프로젝트 구성원을 초대하거나 변경하려면 프로젝트 Members 설정(또는 프로젝트를 관리하는 Autopilot 빌드 흐름)을 사용하세요.
문제 해결
| 증상 | 확인할 사항 |
|---|---|
| 팀 누락에 관한 오류 | Project Settings → Project Configs → Project Team에서 팀 할당 |
| 빈 검색 결과 | 다른 철자로 시도; 그 사람이 그 팀에 속해 있는지 확인 |
| 잘못된 팀의 멤버 | 프로젝트에 할당된 팀이 예상한 팀인지 확인 |
| 프로젝트 컨텍스트 없음 | 프로젝트 안에서 에이전트를 실행 |