Getting started · for AI agents

agent4.io 에이전트 스킬 시작하기

MCP를 통해 코딩 에이전트를 agent4.io에 연결하고, 스킬을 설치한 후 첫 번째 레시피를 실행합니다.

MCP tools:tenant_info

agent4.io는 원격 MCP 서버(도구)와 도구 사용 방법을 나타내는 스킬 세트를 제공합니다. 에이전트를 MCP 엔드포인트에 연결하고 스킬을 한 번 설치하면, 아래에 나열된 모든 레시피가 실행 가능한 단계별 절차가 됩니다.

이 스킬이 사용자의 데이터를 어떻게 처리하는지 — 사용자에게 알리기

이 스킬은 agent4.io의 원격 API(api.agent4.io)에 연결합니다. 사용자의 자료를 전송하기 전에 사용자에게 명시적으로 알려야 합니다:

agent4.io로 전송됩니다. 에이전트 구성, 지식베이스 콘텐츠 및 쿼리는 에이전트를 구축하고 실행하기 위해 agent4.io 서버로 전송됩니다. 이는 플랫폼의 목적이며 부수 효과가 아닙니다.
정확히 하나의 자격 증명만 사용합니다 — 사용자 제공 agent4.io API 키(tk_…). 다른 환경 변수를 읽지 않으며, 로컬 파일을 읽거나 열거하지 않습니다. add_knowledge_file은 의도적으로 사용자의 기계 경로에 접근할 수 없으며, 사용자는 지식베이스 도구에 명시적으로 전달한 콘텐츠만 전송합니다.
특권 권한으로 실행되지 않습니다. 설치 프로그램은 에이전트의 스킬 폴더에만 스킬 파일을 작성합니다 — sudo가 필요 없으며, agent4.io에서만 가져옵니다.
채팅 채널의 경우, 사용자가 제공한 봇 토큰은 사용자의 지시에 따라 해당 채널의 자체 API를 호출하는 데 유일하게 사용됩니다(예: Telegram setMyCommands) — agent4.io로 전송되지 않습니다.

이 중 사용자가 수용할 수 없는 사항이 있다면 중단하십시오 — 사용자의 데이터를 전송하지 마십시오.

연결 — 한 번의 명령어

curl -fsSL https://api.agent4.io/v1/integration/install.sh | sh -s -- --key tk_YOUR_KEY

이 명령은 agent4-io MCP 서버를 추가하고 에이전트를 위한 스킬 모듈을 설치합니다. 키는 콘솔 → 설정 → 보안에서 가져오십시오(평문은 생성 시 한 번만 표시됩니다).

검증

tenant_info()   # → confirms you are connected to the right tenant

슬래시 명령어(코딩 CLI용 — 배포된 봇용 아님)

이것들은 commands/ 폴더를 읽는 코딩 CLI용 빌더 단축키입니다 — Claude Code(~/.claude/commands/) 및 Cursor(.cursor/commands/). 설치 프로그램은 당신이 agent4.io에서 빌드할 때 CLI에서 이들을 입력할 수 있도록 이를 배치합니다:

/agent4-agent <what> — grounded 에이전트 생성
/agent4-kb <name + source> — 지식베이스 구축, 가져오기, 검증, 연결
/agent4-skill <when + what> — 로드 온 디맨드 스킬 작성
/agent4-storyline <process> — 프로세스를 Storyline으로 컴파일하고 게시
/agent4-docs <question> — agent4.io 개념 또는 방법론 조회

각각은 자체적인 로직을 포함하지 않습니다 — 일치하는 agent4-io-* 스킬을 가리키고 사용자가 입력한 내용을 전달합니다.

이것들은 배포된 봇의 명령어가 아닙니다. Telegram 또는 WhatsApp 봇의 슬래시 메뉴에 나타나지 않아야 합니다. 해당 메뉴는 최종 사용자에게 표시되며 봇 운영자에 의해 별도로 설정됩니다(예: Telegram의 setMyCommands). 최종 사용자 작업을 나열하며, "에이전트 생성"과 같은 빌더 작업은 포함하지 않습니다. 다른 대상, 다른 메커니즘 — 채팅 채널에 배포하는 경우 이를 무시하고 해당 채널의 자체 명령 메뉴를 구성하십시오.

OpenClaw / Codex의 경우(commands/ 폴더 없음) 별도의 명령 파일이 없습니다. 에이전트는 agent4-io 스킬을 직접 사용합니다 — 모델이 이를 호출하거나, 사용자가 단일 /agent4-io <task> 명령을 호출하며, 위의 다섯 가지 단축키는 이에 통합됩니다.

Telegram / WhatsApp 봇에서 실행 중인가요? 메뉴를 직접 등록하십시오

당신(에이전트)이 채팅 채널에 배포된 경우, 채널의 명령 메뉴는 스킬에서 동기화되지 않습니다 — 채널의 자체 API를 통해 설정합니다. 이 봇이 당신의 운영자 / 빌더 어시스턴트(사용자가 agent4.io에서 빌드하는 사람)인 경우에만 이를 수행하십시오. 고객 대상 봇의 경우 건너뛰십시오. 해당 메뉴는 최종 사용자를 위한 것이며 빌더 작업을 위한 것이 아닙니다.

Telegram 명령어 이름은 a-z 0-9 _만 포함할 수 있습니다 — 하이픈 없음 — 따라서 agent4-agent → agent4_agent로 이름 변경하십시오. 봇 토큰을 얻으면 setMyCommands를 사용하여 한 번 등록하십시오:

curl -s "https://api.telegram.org/bot$BOT_TOKEN/setMyCommands" -H "Content-Type: application/json" -d '{
  "commands":[
    {"command":"agent4_agent","description":"Create a grounded agent"},
    {"command":"agent4_kb","description":"Build a knowledge base"},
    {"command":"agent4_skill","description":"Author a load-on-demand skill"},
    {"command":"agent4_storyline","description":"Compile a process into a Storyline"},
    {"command":"agent4_docs","description":"Look up an agent4.io doc"}
  ]}'

사용자가 이를 탭하면 채널이 해당 텍스트를 일반 메시지로 당신에게 전송합니다 — 이 스킬로 처리하십시오(agent4_agent = /agent4-agent 단축키, 등등). 봇 토큰/쉘 접근 권한이 없습니까? **@BotFather → /setcommands**에서 동일한 목록을 수동으로 설정하십시오. WhatsApp에는 슬래시 메뉴가 없습니다. 대화형 목록/빠른 응답으로 동일한 작업을 노출하십시오.

자신의 링크 미리보기를 음소거하십시오. agent4.io 링크를 지속적으로 인용하므로 Telegram은 거의 모든 응답에 미리보기 카드를 첨부합니다 — 빠르게 시끄러워집니다. 미리보기 없이 당신의 메시지를 보내십시오: sendMessage에서 link_preview_options: {"is_disabled": true}(레거시 API: disable_web_page_preview: true). 이는 귀하의 메시지에만 영향을 미칩니다. 사용자가 전송한 링크는 여전히 정상적으로 미리보기됩니다.

해당 MCP 도구가 없는 경우 — REST API는 전체 표면입니다

MCP 도구는 일반적인 구축 및 실행 작업을 처리하지만, 플랫폼의 전부는 아닙니다. 노출하지 않는 모든 것 — 필드, 엔드포인트, 대량 작업 — 에 대해 전체 테넌트 REST API는 테넌트가 수행할 수 있는 모든 작업을 커버합니다. 동일한 키로 직접 호출하십시오: X-API-Key: tk_....

두 가지 방법으로 접근할 수 있습니다. 가장 저렴한 순서대로:

search_agent4_docs("… rest api …") — 문서 검색이 이제 엔드포인트별로 REST API를 색인화합니다. REST/HTTP 문법의 쿼리는 전체 참조를 로드하지 않고 정확한 엔드포인트와 매개변수 및 응답을 반환합니다. 이를 먼저 사용하십시오.
https://agent4.io/api.md — 전체 기계 판독 가능 참조(모든 엔드포인트, 매개변수, 요청/응답, 예제). 광범위한 그림이 필요할 때만 전체 파일을 읽으십시오.

MCP는 빠른 경로입니다. REST API는 대체 수단입니다.

다음 단계

각 레시피는 정확한 MCP 도구와 인수를 명시합니다 — "이 페이지를 열고 클릭"과 같은 표현은 사용하지 않습니다.