--- title: "Agents" description: "Console에서 Agent를 만들고 소유자, 지속 동작, 모델, 기능, 환경 변수를 설정하는 방법을 설명합니다." url: "https://ankole.agentbull.com/ko-KR/docs/agents/" lang: "ko-KR" --- > AI Agent용 문서 색인: https://ankole.agentbull.com/ko-KR/llms.txt # Agents Agent는 Ankole Agent Harness 안에서 업무를 지속해서 수행하는 작업 주체입니다. 각 Agent에는 고유한 미션, 소유자, 접근 권한, 도구, 모델 프로필, 파일 공간이 있습니다. 지식 공개 범위에 따라 Company Brain을 사용합니다. 신호 라우팅 규칙은 메시지와 외부 이벤트를 담당 Agent에 연결합니다. ## Agent 생성 1. **Console → Agents**를 열고 **New Agent**를 선택합니다. 2. 필수 display name을 입력합니다. Console은 영어 또는 중국어 텍스트에서 UID를 생성합니다. 예를 들어 `Research Analyst`는 `research-analyst`, `研究分析师`는 `yan-jiu-fen-xi-shi`가 됩니다. 혼합 언어 이름도 동작합니다. 3. UID를 검토하거나 변경한 다음 역할과 선택적 avatar URL을 입력합니다. UID는 이 deployment 인스턴스 안에서 고유한 안정적인 식별자이며, Agent를 저장한 후에는 변경할 수 없습니다. display name은 나중에 변경해도 기존 configuration이 깨지지 않습니다. 4. Agent를 소유할 사람 Principal과 group memory 공개 모드를 선택합니다. 5. Agent를 저장합니다. 그러면 페이지에 해당 Agent의 durable 지침, model profile, Agent별 environment variable이 표시됩니다. 역할(role)은 “Research Analyst”나 “Customer Support”처럼 작업에 대한 짧은 요약을 제공합니다. 아래의 네 가지 durable 문서가 책임, 동작, 시각적 디자인, 기밀성을 관리합니다. ## 소유자와 group memory 공개 설정 모든 Agent에는 소유자가 있어야 합니다. 소유자는 Agent가 작성하거나 보유한 지식과 해당 Agent를 audience로 지정한 지식을 검토할 수 있습니다. 소유자가 Group의 구성원이 아니면 소유권만으로 해당 Group의 지식을 읽을 수 없습니다. group memory 공개 모드는 여러 사람이 답변을 볼 수 있을 때 Agent가 공개할 수 있는 지식을 제어합니다. - **Strict**는 group conversation의 모든 참여자가 memory item의 audience scope를 충족하도록 요구합니다. - **Relaxed**는 질문한 사람만 확인합니다. 다른 참여자는 결과를 좁히지 않습니다. direct message에서는 두 모드가 같은 방식으로 작동합니다. Group이 더 넓은 공개 규칙을 허용하지 않는 한 **Strict**를 사용하십시오. 전체 지식 및 공개 모델은 [Brain](https://ankole.agentbull.com/ko-KR/docs/brain/index.md)을 참조하십시오. ## durable 문서 설정 Agent 페이지에서 **MISSION / SOUL / DESIGN / CONFIDENTIALITY POLICY**를 엽니다. | 문서 | 작성 내용 | |---|---| | `MISSION.md` | Agent가 왜 존재하는지, 어떤 작업을 소유하는지, 완전한 결과가 무엇을 의미하는지 | | `SOUL.md` | 어떻게 커뮤니케이션하는지, 어떻게 결정을 내리는지, 불확실성을 어떻게 처리하는지 | | `DESIGN.md` | 웹 페이지, 슬라이드, 문서, 차트 및 기타 시각적 산출물을 위한 디자인 시스템 | | `ConfidentialityPolicy.md` | Agent가 Brain에 지식을 쓸 때 audience scope를 선택하는 방법 | `DESIGN.md`는 DESIGN.md format을 사용합니다. YAML frontmatter에 색상, 타이포, 간격, 모서리, component 같은 design token을 저장합니다. Markdown 본문은 시각적 원칙과 적용 방법을 설명합니다. Ankole에는 바로 사용할 수 있는 기본 디자인 시스템이 포함되어 있습니다. **Console → Agents → DESIGN**에서 회사 브랜드로 교체할 수 있습니다. 워크플로, 권한 경계 또는 동작 규칙을 `DESIGN.md`에 넣지 마십시오. 그것들은 `MISSION.md`, `SOUL.md`, `ConfidentialityPolicy.md` 또는 특정 Skill에 넣으십시오. `ConfidentialityPolicy.md`는 Agent가 직접 Brain에 쓰는 내용을 안내합니다. chat에서 자동으로 학습할 때는 conversation 참여자가 audience를 결정합니다. 명확한 문서 소수의 집합으로 시작한 다음, 실제 작업이 필요하다는 것을 보여줄 때만 규칙을 추가하십시오. 저장된 변경 사항은 이후의 conversation에 적용됩니다. 이미 실행 중인 작업은 시작할 때 읽은 버전으로 계속됩니다. ## 모델 구성 같은 페이지에서 최소한 `primary`, `light`, `heavy` model profile을 구성하십시오. 이들은 일반 conversation, 가벼운 작업, 복잡한 추론을 담당합니다. 최초 설정에서는 세 가지 모두 이미 검증한 동일한 모델을 사용할 수 있습니다. 선택적 profile은 Agent가 필요할 때만 구성하십시오. - Agent가 이미지를 읽어야 할 때 `vision_fallback`을 구성하십시오. - Agent가 공개 웹 페이지를 검색하거나 읽어야 할 때 `web_search`와 `web_fetch`를 구성하십시오. - Agent가 이미지를 만들어야 할 때 `image_generate`를 구성하십시오. - Job이 별도의 provider 또는 모델을 필요로 할 때 **Background Agent Jobs**를 구성하십시오. ChatGPT 구독은 [ChatGPT subscription provider](https://ankole.agentbull.com/ko-KR/docs/chatgpt-subscription-provider/index.md)를 통해 동일한 provider 선택을 사용합니다. 모델을 선택하거나 입력하기 전에 Provider를 선택하세요. context length 필드도 Provider를 선택한 후 사용할 수 있습니다. 비워 두면 Provider와 모델의 기본값을 사용합니다. 고급 설정에는 선택한 Provider가 선언한 옵션만 표시됩니다. **Reasoning summary**는 Responses API에만 적용됩니다. **Answer detail**은 기본 응답 상세 수준을 설정합니다. **Service tier**는 이 model profile의 request tier를 재정의합니다. 사용 가능한 값은 Provider, 계정, 모델에 따라 다릅니다. 비워 두면 Provider 기본값을 사용합니다. 첫 LLM Provider와 모델 설정은 [Quick start](https://ankole.agentbull.com/ko-KR/docs/quickstart/index.md#llm-providers)를 참조하십시오. ## 토큰 할당량 설정 model profile 옆의 **토큰 할당량** 섹션은 이 Agent가 반복 주기 동안 소비할 수 있는 token을 제한합니다. 주기 길이(일), 주기 시작 시각, token 한도를 설정하십시오. 할당량이 없는 Agent에는 한도가 없습니다. 이 섹션은 사용한 token을 한도 대비 비율 막대로 표시하고, 현재 주기의 시작 시각과 종료 시각을 표시합니다. Ankole은 Agent가 수행하는 모든 model 호출에 대해 provider가 보고하는 input token과 output token을 집계합니다. 예약된 turn, Workflow, Background Agent Job, 그 호출이 시작하는 compaction도 포함됩니다. Brain model 호출, embedding, 웹 tool, 이미지 생성, 사람이 자신의 token으로 보내는 요청은 집계하지 않습니다. Agent가 한도에 도달하면 chat 메시지는 답변 대신 사용한 token, 한도, 주기 종료 시각이 담긴 답장을 받습니다. 해당 Agent의 Background Agent Job은 다음 주기를 기다리지 않고 실패합니다. 한도는 각 model 호출 전에 확인하므로, 호출 하나가 자신의 사용량만큼 한도를 넘겨 끝날 수 있습니다. 차단된 메시지는 재전송되지 않습니다. 사용자가 주기가 끝난 뒤 다시 보냅니다. **주기 재설정**은 그 시점에 새 주기를 시작하므로 Agent가 주기 종료 전에 다시 작업할 수 있습니다. **한도 해제**는 할당량을 제거합니다. 두 경우 모두 사용량 기록은 audit를 위해 남습니다. 다른 지출 레버는 [Cost management](https://ankole.agentbull.com/ko-KR/docs/cost-management/index.md)를 참조하십시오. ## 기능과 environment variable 구성 Agent는 Agent Plugins와 Skills의 deployment 인스턴스 기본값을 상속합니다. 이를 변경하려면 **Console → Agent Library**를 열고 기본값을 편집하거나 이 Agent에 대한 override를 설정하십시오. 전체 절차는 [Agent Library](https://ankole.agentbull.com/ko-KR/docs/skills/index.md)를 참조하십시오. Skill, 명령줄 tool 또는 MCP service에 API key가 필요하면 Agent 페이지의 **Environment variables**에 추가하십시오. Agent별 값은 이 Agent에서만 사용할 수 있습니다. 같은 이름의 전역 값을 override합니다. [Environment variables](https://ankole.agentbull.com/ko-KR/docs/worker-env/index.md)를 참조하십시오. ## chat channel 연결 새 Agent가 Slack, Microsoft Teams, Lark, Feishu, DingTalk, WeCom, Telegram, Discord, LINE, WhatsApp 또는 전용 메일함에서 메시지를 받으려면 먼저 signal routing 규칙이 필요합니다. **Console → Signal routing**을 열고 chat application과 대상 Agent를 선택하십시오. 하나의 chat application에는 여러 규칙을 둘 수 있으며, 서로 다른 Agent를 위해 별도의 bot application을 만들 수 있습니다. [Signal routing rules](https://ankole.agentbull.com/ko-KR/docs/signal-bindings/index.md)를 참조하십시오. ## Agent 변경 또는 비활성화 display name, 역할, durable 지침, 모델, 기능은 언제든 변경할 수 있습니다. UID는 다른 configuration이 Agent를 식별하는 데 사용하므로 변경할 수 없습니다. 비활성화된 Agent는 새 작업을 받지 않지만, "비활성" 상태로 에이전트 목록에 남아 있습니다. 언제든지 다시 활성화할 수 있고, 영구 삭제할 수도 있습니다. 삭제는 비활성화된 Agent에만 가능하며 해당 Agent의 세션, 작업, 관련 기록이 함께 삭제됩니다. 하나의 chat entry point만 중지하려면 Agent 전체를 비활성화하는 대신 관련 signal routing 규칙을 비활성화하십시오. ## Agent가 응답하지 않는 경우 다음 항목을 순서대로 확인하십시오. 1. Agent가 활성화되어 있는지. 2. `primary`, `light`, `heavy` profile이 구성되어 있고 LLM Provider를 사용할 수 있는지. 3. signal routing 규칙이 이 Agent를 가리키는지. 4. worker가 하나 이상 준비되었는지. 5. **Console → Conversations**에 메시지가 있고 유용한 오류가 표시되는지. channel별 확인 사항은 [Quick start troubleshooting](https://ankole.agentbull.com/ko-KR/docs/quickstart/index.md#agent-not-replying)을 참조하십시오.