내장 도구 (및 시스템 MCP)
플랫폼에 기본 제공되는 도구 — 리드 캡처, 문서, 후속 조치, 웹 검색 — 그리고 자동 설치된 시간/날씨/위치 서버.
list_toolsupdate_agent공통 도구를 직접 구축할 필요가 없습니다. 플랫폼이 이를 제공합니다. 해당 에이전트의 업무에 필요한 도구만 update_agent(name, add_tools=[…])로 연결하십시오. 도구 집합은 작게 유지하십시오(see Design principles). list_tools()를 사용하여 테넌트에서의 정확한 이름을 항상 확인하십시오. 이것이 유일한 진실의 원천(source of truth)입니다.
tools=[…]은 전체 목록을 대체합니다.add_tools/remove_tools는 단일 항목을 변경합니다.tools=에 생각 중인 도구만 전달하면, 먼저 읽지 않은 모든 도구가 silently(무음으로) 삭제됩니다. — 이는 실제 운영 환경에서 발생했으며 기능이 작동하지 않게 될 때까지 아무도 눈치채지 못했습니다.tools=는 "정확히 이 세트"라는 의도로 의도적으로 사용할 때만 접근하십시오. 그리고 어떤 경우든 최종 목록을 확인하기 위해 반환된 에이전트를 읽어보십시오. 스킬(add_skills/remove_skills)과 지식 베이스(add_knowledge_bases/remove_knowledge_bases)에도 동일한 쌍이 존재합니다.
내장 도구
| 도구 | 기능 |
|---|---|
web_search | 공개 웹에서 무언가를 검색합니다. |
save_contact | 최종 사용자의 연락처 정보를 프로필에 기록합니다 — 플랫폼의 리드 캡처 / 기록 경로입니다. 에이전트가 사용자에게 전달하는 실제 참조 코드(예: AB2C-D3EF 스타일)를 반환합니다. 사용자의 상세 페이지(recent_refs)에서 코드를 조회하십시오. |
export_document | 대화에 대한 구조화된 문서(브랜드 요약 / 보고서)를 생성합니다. |
schedule_followup | 나중에 능동적으로 후속 조치를 취하거나("2일 후 확인"), 사용자가 요청한 콜백 예약 — 메시지가 자동으로 전송됩니다. 예약된 작업에 추적 가능한 실제 예약 참조를 반환합니다. 절대 시간("내일 오전 10시")의 경우 모델에 run_at(현지 ISO 날짜시간 + 선택적 tz)을 전달하도록 지시하십시오 — 서버가 사용자의 시간대를 해결합니다. delay_seconds는 상대 시간에만 해당하며, 모델은 산술을 잘못 계산합니다. 윈도우: 최대 7일. |
schedule_reminder | 최종 사용자에게 리마인더를 설정합니다. list_reminders / cancel_reminder가 이를 관리합니다. |
compute_chart | 코드 내에서 유도된 시계열을 계산합니다 — 총액 대비 비율, 성장률, 누계 합계, 고정 비율의 투영, 또는 계량 청구(기본 요금 + 할당량 + 단위 초과 요금). 이미 도구가 있는 모든 에이전트에 자동으로 연결되므로, 수동으로 추가할 일이 거의 없습니다. see Charts in answers. |
load_skill도 내장되어 있지만, 연결하지 마십시오 — 모델은 스킬의 description이 일치할 때 자체적으로 스킬을 가져옵니다.
list_tools() # 테넌트에서 사용 가능한 정확한 이름
update_agent(name="Support", add_tools=["save_contact", "schedule_followup"]) # 증분 — 기존 항목 유지save_contact로 연락처를 캡처하면 사용자의 기록이 채워집니다. 에이전트의 ask_forms와 결합하면, 구조화된 수집 정보가 콘솔에서 검토할 수 있는 기록으로 도착합니다.
플랫폼은 이 두 가지를 자동으로 백업합니다. 최종 사용자의 메시지에 명확한 신호 — 전화번호 / 이메일(모든 언어, 영문으로 표기된 숫자 및 공백 형식 포함), 또는 "내일 아침 전화해줘" 스타일의 콜백 요청 — 이 포함되어 있고 save_contact / schedule_followup이 활성화되면, 플랫폼은 모델이 답변하기 전에 도구를 호출하도록 상기시키는 턴별 힌트를 삽입합니다. 운영 환경 백엔드에서 벤치마킹한 결과, 이는 가장 약한 모델의 리드 캡처 준수율을 ~85%에서 100%로 높였으며 제로 잘못된 저장(힌트에는 "잘못된 경우 무시" 탈출구가 포함되어 있어, 과잉 민감한 탐지기가 잘못된 데이터를 생성할 수 없음). 이것은 무료입니다 — 구성 불필요. 스킬은 여전히 description에서 트리거를 명시해야 합니다(see Author a skill). 힌트는 대체물이 아닌 안전망입니다.
시스템 MCP — 이미 설치됨
모든 테넌트에는 기본적으로 활성화된 내장 system MCP 서버가 제공되며, 키가 필요 없는 현지 시간, 날씨, IP 지리적 위치(도시 / 지역 / 시간대) 도구를 포함합니다. 등록할 필요가 없습니다 — 이미 존재합니다. 이 도구는 위의 내장 도구와 함께 list_tools()에 나타나며, 연결할 준비가 되어 있습니다.
따라서 "사용자가 있는 곳의 날씨는 어떻게 되나요?" 또는 "현지 시간이 몇 시인가요?"는 설정 없이 작동합니다 — 플랫폼은 최종 사용자의 클라이언트 IP를 삽입하므로, 위치 인식 답변에는 추가 설정이 필요하지 않습니다.