5가지 AI 핵심 개념

EasyClaw를 사용하기 전에 5분만 투자해 이 개념들을 익혀보세요. AI가 어떻게 작동하는지 진정으로 이해하고 맹목적으로 명령을 입력하지 않게 됩니다.
엔지니어가 될 필요는 없지만, AI가 왜 일을 할 수 있는지, 어떻게 하면 더 정확해지는지, 언제 실수하는지는 알아야 합니다.

1. Agent (지능형 에이전트)

이제 Agent가 어떻게 작동하는지 설명하겠습니다. Agent의 작업 과정은 반복 실행되는 사이클로 생각할 수 있습니다: 작업 이해 → 계획 수립 → 도구 호출 → 동작 실행 → 결과 검증 → 계속 조정 → 보고.

1) 작업 이해:
Agent합니다먼저판단당신필요해결결정무엇문제、성공标정확입니다무엇、입니다아님있습니다약제약 조건건（예를 들어형식、어조、시간간、하지 않能하기무엇）。 예果정보정보하지 않충분, 그것가능能합니다먼저에게당신제공질문, 또는먼저하기반드시필요의假설정그리고설명。

2) 계획 수립 (단계 분해):
큰작업종종필요필요拆완료작은단계骤。예를 들어“정리관리수신건箱”가능분해될 수완료： 스캔이메일 → 식별유형（통신알/계정단일/客사용자/杂항목）→ 판단优먼저레벨 → 归파일 → 시작草돌아가기복잡（예필요필요）→ 汇총清단일。 이一단계결정고정了“먼저하기무엇、후하기무엇”。

3) 도구/능력 호출:
이도입니다Agent能“하기일”의핵심。없있습니다도구, 그것만能멈추留에서문서문자 수준화면의생성议； 있습니다도구가 있으면, 그것바로진짜실제실행실행동작작업, 예를 들어：읽기파일、검색검색정보정보、전송소비정보、访질문企업시스템、생성문서등。 당신합니다보기까지Agent합니다“이동연결외부부분世경계”, 그리고단순히생성한마디。

4) 실행 및 기록:
에서적절한의단계단계에서, Agent합니다진짜실제 트리거전송작업（예를 들어조정사용어떤개서비스연결口、완료완료一회데이터데이터처리、생성일부가능사용내容）。 동일시간그것합니다기록录“나하기까지어느 단계까지단계”, 방법편리후화면계속푸시진입또는돌아가기롤백 수정。

5) 검증 및 오류 수정:
Agent하지 않합니다만追요구“보기시작오완료완료了”, 그것또한합니다결과 확인입니다아님기호통합필요요구。 예를 들어：입력출력입니다아님핵심 필드 누락、입니다아님위반여러분의형식필요요구、입니다아님存에서설명표시오류또는하지 않확실히고정点。 하지 않충족하면합니다다시규칙다음 계획단계, 계속 반복。

6) 결과 보고 및 다음 단계:
마지막으로, Agent합니다을/를그것완료완료의내容、중요필요전송현재、으로및다음단계필요필요당신확실히인식의일항목정리관리에게당신。 당신명확히 알알：그것하기통과무엇、哪일부완료완료了、哪일부또한에서경로上。

2. Skill (스킬)

Agent의循환경里경유자주합니다출력현재“조정사용도구/능력”이一단계, 그리고그一단계조정사용의就통신자주입니다Skill。당신가능을/를그것원함완료：Agent像큰脑, Skill像수동脚와도구 상자。

위해了더심층, 나们을/를“Agent循환경里Skill입니다어떻게작업의”완전히 설명：

1) Agent가 어떤 Skill이 필요한지 판단
때작업진입실행실행단계, Agent합니다분析때이전단계骤필요필요哪일부능력。 예를 들어“查찾기어떤개客사용자의기록史커뮤니케이션기록录”필요필요“检검색/읽기”유형Skill； “시작초안진입이메일”필요필요“생성문서본/套모델板”유형Skill； “을/를작업동기화까지대기办시스템”필요필요“쓰기入/더새”유형Skill。

2) Agent가 Skill에 매개변수를 채움 (입력)
Skill통신자주필요요구특별고정의입력형식, 예를 들어：키워드、시간간범위围、客사용자ID、목표받众、입력출력위험格등。 Agent합니다을/를컨텍스트제공取출력오그리고정리관리완료Skill모든필요의참여데이터。
이一단계결정고정了실행실행입니다아님정확확실히：입력하지 않对, 입력출력큰概율就합니다偏。

3) Skill이 실행되어 결과를 얻음 (출력)
Skill실행실행후합니다돌아가기구조화또는반구조화결과, 예를 들어：检검색까지의条목록列표、계획계산결과、생성의문서문서본、연결口돌아가기의상태상태코드등。 이러한결과를Agent다시회读돌아가기, 사용于후续결정전략。

4) Agent가 출력을 검증하고 다음 단계로 진행 (폐루프)
Skill하기완료하지 않입니다종점, Agent또한합니다확인：결과입니다아님충족약束、입니다아님存에서누락정보정보、입니다아님필요필요二회생성또는수정正。 예果하지 않충족, 그것가능能합니다조정사용다른一개Skill（예를 들어“보충보충 검색검색”“중요쓰기문서案”“형식화입력출력”）다시반복。 이就입니다Skill와Agent의“协동일닫기환경”。

예시: 당신让Agent“에게潜에서客사용자쓰기跟진입이메일, 그리고생성생성대기办”。
이는 일반적으로 여러 Skill을 연결하여 완전한 동작 체인을 형성합니다:

1) 고객 정보 검색 Skill: 고객 ID/이름을 입력하여 이름, 회사, 최근 커뮤니케이션 요점 출력;
2) 정보 추출/요약 Skill: 커뮤니케이션 기록을 입력하여 주요 문제점과 합의된 사항 출력;
3) 이메일 생성 Skill: 어조(전문적/친근함), 템플릿(후속/성사 유도), 주요 포인트를 입력하여 이메일 본문 출력;
4) 할 일 생성 Skill: 이메일 내용과 행동 제안을 입력하여 할 일 항목(담당자, 마감일, 단계) 출력;
5) 일정/할 일 시스템 쓰기 Skill: 구조화된 할 일 데이터를 입력하여 생성 성공 상태 또는 링크 출력.

당신합니다전송현재：Agent보기시작오像입니다에서“합니다하기영업작업”, 하지만이背후입니다Skill모듈을/를진짜실제능력 조합완료하나개작업流。 Agent부담책임을/를이러한능력따라对의순서사용시작오。

계속사용Agent의“실행循환경”오이해Skill：Agent부담책임생각고려와조정도, Skill부담책임실행실행구체적단계骤。 때Agent전송현재작업필요필요어떤항목능력시간, 就합니다선택择적절한의Skill, 을/를필요필요의참여데이터塞진입이동, 등대기그것돌아가기결과, 다시을/를결과 가져오기돌아가기循환경里하기검증、보충充또는다음단계규칙划。

예시: 당신让Agent“도움나쓰기고객사용자跟진입이메일그리고생성대기办”。
다음과 같은 다양한 Skill을 호출할 수 있습니다:
1) 고객 정보 검색 (이름, 최근 커뮤니케이션 요점 확보);
2) 이메일 초안 생성 (어조/길이/템플릿에 따라 출력);
3) 할 일 목록 생성 (다음 단계 행동을 항목으로 분해).
이러한Skill拼시작오, 비로소形완료“보기시작오매우합니다하기”의Agent실행위해。

3. Prompt (프롬프트)

가능전송현재Prompt과이전화면두개개념（Agent / Skill） 입니다동일하나의실행로직의다른一화면：Agent필요필요Prompt오결정고정어떻게하기, Skill필요필요Prompt오결정고정입력무엇와검증 방법。

“Agent의작업循환경”가능被이해위해：
이해작업 → 제어고정계획划 → 결정전략조정사용Skill → Skill실행실행 → 결과 확인 → 계속조정정리 → 汇보고。
Prompt의 역할은 각 단계마다 규칙을 제공하여 Agent가 방향을 잃지 않고, 근거 없이 추측하지 않으며, 폐루프를 형성할 수 있도록 하는 것입니다.

1）Prompt먼저고정义“목표와성공标정확”（위해무엇하기）
이一단계결정고정了Agent의“判분규칙则”。Prompt필요필요알림诉그것：당신필요해결결정의까지하단입니다무엇문제、 으로및무엇결과계산완료완료。
예를 들어：하지 않입니다“도움나쓰기이메일”, 그리고입니다“이메일반드시해야포함포함된일부단락、어조는 어떤지、긴도범위围、마지막으로필요에게출력다음단계대기办”。

없있습니다성공标정확의Prompt, Agent就만能하기“보기시작오차이하지 않다중”의입력출력, 难으로검증품질양。

2）Prompt에게출력“触전송条건와약束”（무엇시간候하기무엇）
실행 가능한 Prompt는 일반적으로 언제 Skill을 호출해야 하고 언제 질문해야 하는지 명확히 작성합니다.
예를 들어：때고객 누락사용자姓이름또는일기간시간, 반드시해야먼저검색取, 그리고하지 않입니다기본인식“따라편리쓰기개姓이름/일기간”。

이는 불확실성을 줄이는 것과 같습니다: 제약이 명확할수록 Agent가 더 안정적입니다.

3）Prompt설명“필요필요哪일부Skill, 으로및매개Skill의입력입력출력약고정”（사용무엇도구하기）
Prompt에 명시해야 할 사항:
필요조정사용어느Skill、그것필요필요의입력필드입니다무엇、입력필드부터어디오、형식필요요구입니다무엇；
동일시간필요설명확실히：Skill입력출력해야해당으로무엇구조돌아가기（예를 들어JSON필드、列표、표格、固고정단락 구조등）。

이一단계입니다Prompt진짜正“工프로세스화”의핵심：让Agent을/를“다음단계어떻게하기”변경완료“가능실행실행의능력조정사용”。

4）Prompt필요요구“검증 및 실패 처리”（하기완료어떻게판단对하지 않对）
단순히 결과를 생성하는 것만으로는 충분하지 않으며, Prompt는 검증 규칙과 실패 전략을 명시해야 합니다. 일반적인 작성 방법:
- Skill 호출 실패/빈 결과 반환: 먼저 원인 진단(매개변수 오류/권한/네트워크/데이터 누락) 후 재시도 또는 폴백;
- 출력에 핵심 필드 누락: 반드시 보완하거나 사용자에게 질문하고 무리하게 추측하지 않음;
- 형식하지 않기호통합：触전송“형식화Skill/중요정렬Skill/다시생성”。

이让Agent하지 않합니다빠짐“反복잡입력출력하지만하지 않수신敛”의循환경。

5）Prompt고정义“최终입력출력형식”（입력출력필요에게谁사용）
마지막으로Prompt필요규칙고정결과어떻게呈현재：哪일부필드반드시해야돌아가기、필드이름입니다무엇、입니다아님필요필요구조화결과、 입니다아님필요필요附가져오가능추적정보정보（예를 들어“입니다아님조정사용了Skill、조정사용了어느Skill、핵심입력입력출력입니다무엇”）。

4. Memory (메모리) / MEMORY.md

예를 들어당신알림诉Agent：“나偏좋은간결의에서문서돌아가기복잡, 代코드사용Python”。
예果이선호도좋은으로적절한의형식쓰기入Memory, 그么이후Agent다시처리相동일유형작업시간, 합니다기본인식따름이러한규칙则； 당신就하지 않필요필요反복잡强조정, 도더하지 않발생하기 쉬운생성“매회돌아가기복잡위험格하지 않一초래”의문제。

위해了확보Memory진짜正“가능사용”, 그것필요필요具준비이전화면세 가지의标정확：稳고정触전송、입력명확、입력출력가능검증。 즉, Memory에 기록된 내용은 Agent가 다음에 무엇을 해야 하는지 명확히 안내할 수 있어야 하며, 막연한 감정 표현이 아니어야 합니다.

생성议을/를Memory쓰기완료이러한“규칙규칙 명확단일”위험格：

• 쓰기작업위험격식 선호좋은：예를 들어“에서문서且간결”“결론먼저실행”“매段하지 않超통과3句”
• 형식필요요구：예를 들어“代코드사용Python”“표格입력출력필드포함含A/B/C”“일기간형식YYYY-MM-DD”
• 결정전략SOP：예를 들어“전송현재정보정보하지 않足먼저제공질문, 하지 않필요추측；에게출력준비선택방법案그리고标참고위험险”
• 장기컨텍스트：예를 들어“우리 팀은 B2B 납품”“자주사용도구위해XX（예적용）”

5. Soul (소울) / SOUL.md

예果말하기Memory입니다「기록기억무엇」, 그Soul就입니다「규칙고정了완료위해무엇样의AI」。 예를 들어：만돌아가기제품 관련 답변문제；财업무작업반드시해야二회확실히인식；금지검색필요密코드또는敏느낌자격 증명； 涉및방법律/의료시간반드시해야에게출력免책임声설명그리고인용인간 상담 안내/전용업채널등。

생성议당신을/를SOUL쓰기완료“가능실행실행의규칙규칙 명확단일”, 그리고커버으로다음 몇 가지유형내容：

• 허용되는 작업：Agent의 작업 범위와 영역 경계 (예: 제품 문의/내부 프로세스만 처리).
• 금지되는 작업：고위험 행동에 대한 명시적 거부 (예: 비밀번호/키 요구; 불확실한 결과 약속; 권한 우회).
• 확인이 필요한 작업：송금, 환불, 계약, 권한 변경 등 2차 확인이나 승인이 필요한 규칙.
• 출력 방식과 어조：예: 반드시 예의 바르게, 인신공격 금지, 위협적인 표현 사용 금지.
• 경계 상황 처리 방법：완료할 수 없을 때 대체 방안 제시 (예: 기록 후 담당자에게 전달/전문 부서 상담 권장).

고급 개념 (선택 사항)

으로다음개개념합니다让당신더“懂자동화”。그것们그리고하지 않입니다다른시작새로 시작의알지식 포인트, 그리고입니다을/를이전화면讲통과의 Agent / Skill / Memory / Soul / Prompt 이套실행로직, 진짜실제 구현까지“실행 가능시작오、연결 가능시작오、안정적고정수집완료”의层화면。 새수동가능먼저跳통과；때당신시작하기다중단계단계 흐름프로세스、연결외부부분서비스또는정렬查데이터데이터전달문제시간, 다시돌아가기오보기합니다매우省시간간。

🔀 1) Workflow (워크플로우)

Workflow（작업流）가능이해완료하나의가능복잡사용의실행실행경로线：을/를여러단계단계 연결시작오, 让시스템따라순서완료완료一개목표。 예果말하기Agent입니다“합니다원함、합니다실행실행의동일일”, 그Workflow就입니다“에게이位동일일정렬좋은의작업대기열과衔연결방법式”。 그것해결결정의입니다：때작업하지 않입니다한마디바로완료완료의시간候, 어떻게 안정적으로고정로컬을/를다중단계실행실행하기완료链경로。

일반적인 Workflow는 다음과 같은 요소를 포함합니다 (이 관점으로 EasyClaw의 다단계 능력을 이해할 수 있습니다):

• 단계 목록：1단계에서 무엇을 하고, 2단계에서 무엇을 할지... 각 단계의 책임 경계가 명확함.
• 입력과 출력：매一단계모두해야해당产생성가능다음에 의해단계사용의구조화결과, 그리고하지 않입니다만에게“문서문자 설명”。
• 조건과 분기：예를 들어“예핵심 필드가 누락되면먼저제공질문/먼저보충检검색”, 아님바로연결다음 단계로。
• 검증 및 실패 처리：예를 들어“해결분석 실패실패就중요试또는돌아가기退까지준비사용방법案”。
• 취합 출력：최종 결과를 사용 가능한 형태로 전달 (목록, 보고서, 작업 목록, 알림 내용 등).

Workflow를 앞선 개념들과 어떻게 연결할까요? 한 문장으로 정리할 수 있습니다:
Agent부담책임결정전략와조정도, Skill부담책임구체적실행실행, Memory/Soul부담책임장기규칙则와边경계, Prompt부담책임알림诉그것“어떻게하기”, Workflow부담책임을/를이러한단계骤따라순서연결완료链경로。

예시: 당신필요완료완료“을/를사용자투자诉업그레이드레벨위해工단일, 그리고통신알부담책임人”。 합리적인 Workflow는 다음과 같을 수 있습니다:

1. 입력 수집：양식/메시지에서 불만 내용, 사용자 정보, 타임라인을 가져옴.
2. 정보 추출：Agent를 사용하여 불만 요점을 구조화 (예: 문제 유형, 영향 범위, 주요 시점).
3. 규칙 판단：Soul/규칙에 따라 높은 우선순위인지, 에스컬레이션이 필요한지 아니면 추가 정보 수집이 필요한지 판단.
4. 티켓 생성 Skill 호출：구조화된 필드를 티켓 시스템 인터페이스에 입력하여 티켓 번호 생성.
5. 알림 Skill 호출：티켓 번호와 요점 요약을 담당자에게 전송 (Feishu/이메일/IM).
6. 결과 검증：티켓 생성 성공 상태 반환 확인, 알림 전송 여부 확인.
7. 취합 피드백：에게사용자또는관리버전입력출력“이미생성생성工단일 + 링크/번호 + 다음 단계 처리 제안”。

당신합니다전송현재：Workflow해결결정의하지 않입니다“어떻게쓰기일부해결释”, 그리고입니다“어떻게을/를여러도구조정사용와검증단계骤가능靠로컬串시작오”。 때당신시작하기복잡복잡한 흐름프로세스（尤그跨시스템：IM + 工단일 + 데이터데이터库）시간, Workflow就합니다완료위해당신최의존의능력。

📦 2) JSON (데이터 교환 형식)

JSON입니다Agent와외부부분도구、API간전달데이터데이터의标정확형식。 에서다중단계骤자동화里, JSON의작업사용非자주핵심：그것让“다음단계能하지 않가져올 수까지正확실히데이터데이터”변경완료가능검증의문제, 그리고하지 않입니다“직관으로 자연어를 이해하는 대신자연언어”。

당신가능을/를JSON이해위해：시스템내부분의“구조화데이터데이터袋”。里화면설치의하지 않입니다흩어진 문장, 그리고입니다설명확실히필드와유형, 예를 들어： 工단일제목、사용자ID、优먼저레벨、마감일기간、통신알내容등。

EasyClaw의 작업 체인에서 JSON은 일반적으로 다음과 같은 위치에 나타납니다:

• Skill의 입력과 출력：Skill은 종종 특정 필드를 입력으로 필요로 하며, Agent의 의사 결정을 위한 구조화된 결과를 반환합니다.
• API 호출 매개변수：예: Feishu 인터페이스 호출 시 매개변수를 필드별로 JSON으로 구성해야 함.
• 단계 간 데이터 전달：Workflow의 특정 단계 출력 JSON이 다음 단계에서 읽힘.

그위해무엇많은문제보기시작오“像Agent하지 않합니다하기”, 그실제입니다JSON의원인？ 자주보기상황况포함：

• 필드명 불일치：예: input으로 user_id를 기대했지만 실제로는 userId가 전달됨.
• 필드 누락：예: 필수 필드가 누락되어 인터페이스가 오류를 반환.
• 유형 불일치：예: 날짜는 문자열이어야 하는데 숫자로 전달되거나, 배열이어야 하는데 텍스트가 제공됨.
• JSON 형식 오류：따옴표 누락, 괄호 부족, 끝에 쉼표 추가 등으로 파싱 실패.

그러므로당신정렬查수집완료문제의최佳순서통신자주입니다： 먼저보기JSON, 다시보기Prompt, 다시보기Agent의판단로직。 因위해JSON입니다“能하지 않실행 가능통신”의하단座。

🔑 3) API Key (접속 키)

API Key입니다访질문AI모델型또는제三방법서비스할 때의본인자격 증명。 없있습니다正확실히의API Key, 시스템통신자주就불가조정사용对해야모델型또는서비스；就계산Agent푸시관리얻다시좋은, 도만能멈추留에서“불가실행실행”의상태상태。

EasyClaw 시나리오에서는 두 가지 상황을 구분해야 합니다:

• 기본인식사용官방법능력/积분의상황况：새수동일반없음필요자체준비Key, 因위해平플랫폼이미도움당신완료완료了연결。
• 연결사용자 정의 모델/자체고정义서비스의상황况：당신필요필요에서相해야位설정입력쓰기API Key, 그리고대응하게해야의Agent/Skill지정에게해당모델型。

API Key하지 않단지입니다“能하지 않能사용”, 또한영향“사용무엇능력、완료본와稳고정성능”：

• 모델 선택：Key/모델에 따라 추론 품질, 속도, 출력 형식 성능이 달라질 수 있습니다.
• 비용 관리：일부 플랫폼은 사용량에 따라 과금되며, Key에 연결된 계정/할당량이 사용 가능 비용에 영향을 미칩니다.
• 권한 범위：일부 서비스의 Key는 제한된 인터페이스 호출만 허용하여 특정 Skill 실행이 실패할 수 있습니다.

정렬查“Skill조정사용失실패”의자주보기생각경로포함： Key가 올바르게 입력되었는지 확인、Key입니다아님통과기간/금액도하지 않足、해당Key입니다아님具준비조정사용권한。 예果API돌아가기인증오류（401/403유형）, 优먼저의심API Key설정설정문제。

언제 이것들을 진지하게 봐야 하는가? (빠른 참조)

• 당신필요하기다중단계骤자동화：Workflow합니다결정고정链경로能아님稳고정跑통신。
• 당신필요연결Feishu/企업시스템/외부부분연결口：JSON결정고정데이터데이터能아님正확실히전달、能아님被해결析。
• 당신필요연결자신의모델型또는자체고정义서비스：API Key결정고정能아님조정사용까지对해야능력。
• 당신에서정렬查“能해결释하지만하지 않能실행실행”또는“실행실행失실패하지만하지 않알원인”：통신자주부터Workflow串연결、JSON구조、API Key권한이세 곳 확인회정렬查합니다최빠르。