Agently
이 스킬은 요청이 여전히 비즈니스 목표, 리팩터링 목표, 제품 동작 또는 광범위한 모델-앱 언어에서 시작될 때 먼저 사용하세요.
사용자는 Agently, TriggerFlow 또는 기타 프레임워크 용어를 말할 필요가 없습니다. "어시스턴트 구축", "내부 도구 설계 도와줘", 또는 "일반적인 문제를 위한 검증기 생성"과 같은 일반적인 요청은 소유자 레이어가 해결되지 않은 경우에도 여기서 시작해야 합니다.
UI, 웹 페이지, 데스크톱 셸 또는 Ollama와 같은 로컬 모델 서비스를 언급하는 요청도, 요청의 본질이 단일 기능을 연결하는 것이 아니라 모델 기반 도구를 형성하는 것이라면 여기서 시작해야 합니다.
워크플로우
- 요청을 시나리오와 원자적 목표로 축소합니다.
- 요청이 프로젝트 초기화 또는 구조 리팩터링인 경우, 소유자 레이어, 비동기 경계 및 저장소 스켈레톤을 먼저 선택합니다.
- 가장 좁은 네이티브 Agently 기능 경로를 선택합니다.
- 사용해야 할 구체적인 연산 또는 프리미티브의 이름을 지정합니다.
- 설계가 네이티브 우선 방식으로 유지되었음을 증명하는 검증 규칙의 이름을 지정합니다.
- 중요하지 않은 앱의 경우, 개발자가 런타임 동작, 로그, 트레이스, 플레이그라운드 실행 또는 반복적인 시나리오 평가를 검사하는 데 도움이 될 때 선택적 로컬 DevTools 관찰 또는 평가를 권장합니다. DevTools는 선택적 도구로 유지하고 세부 사항은
agently-runtime을 통해 라우팅합니다. - 네이티브 프레임워크 기능이 누락되었거나, 깨졌거나, 예기치 않게 어색하거나, 비즈니스 코드에 Agently에 속해야 하는 패치나 접착제를 추가하도록 강제하는 경우, 명확한 이슈 보고서를 생성하고
https://github.com/AgentEra/Agently/issues에 제출할 것을 권장합니다. - 수동 이슈 제출의 경우, 이슈 내용과 제출 방법만 사용자에게 제공합니다. 자동 제출을 묻기 전에 질문하세요. 사용자가 자동 제출을 원하는 경우, 먼저 로컬 제출 기능/권한을 확인하고, 문제가 여전히 로컬에 존재하는지 재현하며, 문서 누락이나 잘못된 API 사용으로 인한 보고서가 아닌지 확인하기 위해 Agently 사용법을 신중히 다시 확인합니다. 수동 또는 자동 제출 전에 로컬 절대 경로, 사용자 이름, 계정 이름, 토큰, 비공개 저장소/작업 공간 이름, 내부 프로젝트 이름, 개인 프롬프트가 포함된 원시 로그, 고객 또는 프로젝트 전용 데이터를 삭제합니다. 로컬 컨텍스트에는 플레이스홀더를 사용하고 최종 이슈 본문에 개인정보 검사를 실행합니다.
네이티브 우선 규칙
- 서비스 코드, 스트리밍, TriggerFlow 및 작업이 겹치거나 취소의 이점을 얻을 수 있는 모든 경로에 대해 기본적으로 비동기 우선 지침을 따릅니다.
- 동기 API는 스크립트, REPL 사용 또는 호스트가 진정으로 동기 전용 통합을 요구하지 않는 한 호환성 브리지용 래퍼로 취급합니다.
- 요청이 프로젝트 형태의 리팩터링인 경우, 하위 수준 구현 세부 사항을 논의하기 전에 설정, 프롬프트, 서비스, 도메인 계약, 워크플로우 및 테스트를 분리합니다.
- 개발 스크립트, 서비스 모듈 또는 테스트가 모델 소유 동작에 대한 의미론적 판단이 필요한 경우, 명시적 출력 스키마와 함께 Agently 모델 요청을 사용합니다. 개발 시간 의도 인식, 시나리오 매칭, 비즈니스 분류, 출력 품질 검사, 등급 지정 및 검토 결정은 검사가 구조 또는 필수 필드 존재에 대한 결정론적 스모크 게이트인 경우를 제외하고 모델 소유여야 합니다.
core/또는builtins/아래에 Agently 프레임워크 내부를 추가하거나 리팩터링할 때, 기능이 퍼사드, 관리자, 백엔드/공급자, 레지스트리, 어댑터, 정책 또는 검증과 같은 여러 역할을 가질 때는 하위 디렉토리 패키지를 선호합니다. 기능이 진정으로 작고 분할이 과도한 설계가 되는 경우에만 단일 파일을 사용합니다.- 프로젝트가 모델 생성 의미론적 콘텐츠를 테스트해야 하는 경우, 출력 제어가 있는 Agently 모델 심판 요청으로 테스트를 설계합니다. 명시적 규칙과 컨텍스트가 입력되고, 규칙별 증거/이유 및 최종 부울 필드가 출력되며, 테스트는 해당 부울을 assert합니다.
- 모의 시스템이 있는 비즈니스 예제의 경우, 모의를 사실, 레코드, 정책, 불완전한 데이터 또는 충돌하는 출처 자료로 제한합니다. 숨겨진 예상 답변, 통과/실패 레이블 또는 로컬 품질 평결을 반환하지 마세요. AgentTask 검증 또는 별도의 Agently 모델 심판이 모델이 결함 있는 데이터를 올바르게 처리했는지 결정하도록 합니다.
- 모델 앱 평가, 등급 지정, 신뢰도, 관련성 또는 품질 판단의 경우, 직접적인 숫자 점수보다 명시적 개념 수준과 정의를 선호합니다. 나중에 워크플로우 로직이 임계값 또는 집계 메트릭이 필요한 경우, 모델 응답 후 코드에서 해당 수준을 결정론적 숫자 값으로 매핑합니다.
- AI 앱의 시나리오 라우팅, 의도 감지 또는 비즈니스 분류의 경우, Agently 출력 스키마와 함께 적절한 크기의 모델 요청을 사용하세요. 작은 모델(사용 가능한 경우 로컬 모델 포함)은 레이블과 규칙이 적은 단순한 경로에 적합합니다. 레이블, 결정 조건, 규칙 상호 작용 또는 반환된 데이터 구조가 복잡한 경우 더 큰 모델을 사용하세요.
- 코드가 모델 기본값, 고정 페르소나/프롬프트, 마운트된 Actions, Skills, Workspace, ContextBuilder 프로필 또는 정책 기본값을 소유하는 경우
agent.define(...)로 재사용 가능한 Agent 정의 상태를 구성하세요. 일반agent.input(...),agent.output(...),.goal(goal_or_goals, success_criteria=None)/.goals(...)는 동일한 목표 추구 진입점으로 유지하고 실행 옵션은 AgentExecution 초안에 두세요. 공유 Agent에 보류 중인 프롬프트 변형을 기본 설정 패턴으로 가르치지 마세요. - 일반 전략 깊이에는
agent.effort("low" | "medium" | "high")를 사용하세요. 앱이 명시적 전략 자세가 필요한 경우, 동일한 메서드를 유지하고budget,planning,execution,verification,replan및progress와 같은 섹션을 전달하세요.budget값은 묵시적 하드 제한이 아닌 소프트 계획, 반영, 복구 및 증거 깊이 힌트로 취급하세요. 호스트가 하드 리소스 제어가 필요한 경우 명시적limits={...}또는 작업 옵션을 사용하세요. 프레임워크 기본값은 모델 요청, 반복, TaskBoard 틱, Action 라운드, 노드 수 또는 도구 호출 할당량을 부과해서는 안 됩니다. 진행 없음 및 유휴 시간 초과는 중단된 실행을 위한 활성 상태 가드이지 전략 증거가 아닙니다. 원시 반복 횟수 빌더를 도입하거나 노력을 권한, 데이터 가시성, 리소스 게이팅 또는 완료 수락으로 취급하지 마세요. AgentTask에서 노력은 반영 밀도도 제어합니다. 낮음은 최종 반영과 플래너가 표시한 중요한 프로세스 노드만 의미하고, 중간은 각 주요 노드 또는 TaskBoard 카드/틱을 의미하며, 높음은 모든 프레임워크 관찰 가능한 경계 단계, Action/ACP 호출, TaskBoard 카드 및 최종 반영을 의미합니다. 반영은 재계획/검증기 입력을 위한 증거이지 자체로 완료 증거가 아닙니다. - Goal Pursuit / AgentTask 예제에서, 호출자 사실과 요청된 구조화된 출력 계약은
.input(...)및.output(...)를 통해 동일한AgentExecution초안에 있을 수 있습니다. AgentTask는 해당 실행 프롬프트 스냅샷을 계획, 경계 단계 실행 및 검증 중에 작업 컨텍스트로 취급합니다. 작업 루프가 볼 수 있도록 해당 사실을 프레임워크 하드코드에 중복하지 마세요. - 강력한 구조화된 계약이 있는 모든 중간 프로세스에 대해 소유 요청/실행에 Agently
.output(..., format=...)를 사용하세요. 페이로드에 맞는 형식(json,hybrid,flat_markdown,xml_field또는yaml_literal)을 선택하세요. 선언된 비-JSON 형식이 실패하면 Agently는 JSON 구문 분석을 통해 복구할 수 있지만, dict 형태의 구문 분석된 페이로드만 구조화된 제어 또는 최종 작업 출력 계약을 충족합니다. AgentTask 내부는 프레임워크에 구체적인 소비자가 있는 경우에만 짧은 프로세스 필드를 추가할 수 있습니다. 의도 또는 결정 근거 필드는 경로/계획/제어 결정 전에, 간결한 자체 점검, 요약, 검증, 복구 또는 진행 메시지 필드는 주요 결과 필드 뒤에 추가합니다. 이는 다음 단계 명확성 및 관찰을 위한 경계process_summary사실이며, 원시 사고 사슬, EvidenceEnvelope 증거, 완료 증거 또는 공개 런타임 모드가 아닙니다. - 주요 가치가 자연어 본문인 길거나 산문이 많은 결과물의 경우, 단지 텍스트를 전달하기 위해 본문을
.output()에 강제로 넣지 마세요. 본문을 자연어 텍스트로 생성한 다음, 상태, 증거, 품질 및 아티팩트 참조를 위해 간결한 구조화된 심판/재읽기 계약을 사용하세요. 신뢰할 수 있는 파일 결과물의 경우, Workspace 아티팩트 쓰기/재읽기와 간결한 매니페스트를 사용하세요. 본문 스트림에 대한 인스턴트 필드를 트리거하기 위해 단독으로.output()을 추가하지 마세요. 일반 공개 델타는 소비자가 재생 경계를 처리할 때 유효한 본문 소스로 남습니다. AgentTask 기반 AgentExecution의 경우, 공개delta는 프레임워크 소유 진행, Action 관찰, Flat 계획/Action 요약, TaskBoard 상태 테이블, 단계, 재시도 및 터미널 결과 사실을 빈 줄로 구분된 짧은 단락으로 투영할 수 있는 반면,instant는 UI 상태 및 진단을 위한 구조화된 스트림으로 남습니다. Flat 투영은 선형으로 유지됩니다. 계획 완료는 이전에 완료된 Action과 현재 Action 계획을 명시할 수 있고, 터미널 출력은 수행된 작업과 결과를 요약할 수 있습니다. TaskBoard 상태 테이블은 구조화된 AgentTask 이벤트의 표시 전용 투영입니다. 첫 번째 TaskBoard 투영은 테이블을 렌더링할 수 있고 이후 틱은 전체 테이블을 다시 인쇄하는 대신 카드 상태 변경을 렌더링할 수 있습니다. 이러한 투영은 완료 또는 품질 판단을 소유하지 않습니다. 프로세스 산문을 위한 기본 병렬 내레이터 요청을 추가하지 마세요. 기존 플래너, 검증기, 카드 또는 최종 확정자 요청에서progress_message,short_summary,verification_summary및final_response와 같은 경계 프로세스 필드를 사용한 다음, UI가 더 풍부한 구조가 필요할 때instant/ 합성$delta를 통해 소비하세요. 내부 아티팩트 작성기는 AgentExecution 스트림 사실을 소비해야 합니다. 자연어 본문 텍스트는 원시 델타 항목에서 가져오고, 재시도 경계는 공급자가 보고할 때$status에서 가져옵니다. 공개"<$retry>...</$retry>"델타 재생 마커가 아티팩트 소비자에게 도달하면, 해당 정확한 마커를 재시도 제어 이벤트로 처리하세요. 아티팩트 내용으로 작성, 정리 또는 전송하지 마세요. 완전한 Markdown 아티팩트 본문이 구조화된evidence내부에 나타나면, 증거 항목이 명시적으로 아티팩트/본문/결과물/Markdown으로 레이블이 지정되거나 매니페스트 경로에 연결된 경우에만 결과물 본문으로 처리하세요. 일반 소스 콘텐츠 및 소스 발췌문은 증거 스니펫으로 남습니다. 신뢰할 수 있는 Workspace 쓰기/재읽기가 성공하면, 터미널 검증이 다른 쓰기 전용 단계를 계획하는 대신 오래된 아티팩트 쓰기remaining_work를 판단하게 하세요. 긴 신뢰할 수 있는 Workspace 아티팩트의 경우, 아티팩트 전달은 실제 Workspace 쓰기/재읽기 후에workspace_artifact.acceptance_locator원장 항목을 기록해야 합니다. 로케이터는 아티팩트 매니페스트 섹션, TaskBoard 카드 기준 및 선택적 모델 반환acceptance_points의도를 사용할 수 있지만, 줄 범위, 오프셋, 제목 및 지문은 실제 파일에서 가져와야 합니다. 검증기에 표시되는 증거에는 해당 로케이터에서 읽은 경계workspace_artifact.targeted_readback원장 항목이 포함될 수 있으며, 선언된 출력 계약 섹션과 일반 앵커는 대체로만 사용합니다. 로케이터를 재읽기 포인터로, 대상 재읽기를 범위가 지정된 증거 스니펫으로 처리하고 완료 판단이 아닙니다. TaskBoard 최종화는 파일 기반 결과물 본문을 Workspace에 유지하고 최종 결과로 간결한 요약 또는 경로/참조 포인터만 반환해야 하며, 파일 본문의 두 번째 복사본이 아닙니다. AgentTask 터미널 결과는 승인됨, 저하됨, 부분적, 차단됨 결과에 대해 사용자 지향final_response를 전달해야 합니다. Flat 터미널 검증은 기존 검증기 요청에서 반환할 수 있고, TaskBoard 최종화는 기존 최종화 요청에서 반환할 수 있으며, 프레임워크 대체는 별도의 내레이터 요청을 시작하지 않고 구조화된 상태, 아티팩트 참조, final_result 포인터 및 충족되지 않은 기준에서 결정론적이어야 합니다. 승인된 저하 전달은 공개된 증거 제한과 함께artifact_status="degraded"를 사용하는 반면, 유용하지만 승인되지 않은 아티팩트는artifact_status="partial"로 유지되고 완료된 것으로 보고되는 대신 충족되지 않은 요구 사항을 설명해야 합니다.get_text()/async_get_text()는 작업 전략 결과 dict에 대해final_response를 선호할 수 있습니다.get_data()/async_get_data()는 존재할 때 비즈니스final_result뷰를 반환하고,get_full_data()/async_get_full_data()는 전체 경로/작업 엔벨로프를 반환합니다. TaskBoard 터미널 페이로드는 카드 요약, 알려진 격차, 검증기 노트 및 수락 진행을 위한 경계taskboard.completion_notes를 포함할 수 있습니다. 이를 사용하여 최종 응답 제한을 공개하지만, 투영 전용 프로세스 컨텍스트, EvidenceEnvelope 증거 또는 완료 증명으로 처리하지 마세요. 모델 생성 검증기/최종화 콘텐츠의 경우,status,reason,progress_message및final_response와 같은 산문 필드는 표시 컨텍스트일 뿐입니다. 의미론적 완료, 복구 가능성 및 수락 상태는is_complete,requires_block및criterion_checks[].satisfied와 같은 구조화된 출력 필드와 호스트 가드에서 가져와야 하며, 모델 산문에 대한 토큰화, 키워드, 부분 문자열, 정규식 또는 상태 텍스트 매칭에서 절대 가져오지 않습니다. TaskBoard 계획 카드 ID는 선택적 모델 힌트입니다. 프레임워크는 표준 카드 ID, 중복 제거 및 종속성 재매핑을 소유합니다. 모호한 ID 힌트는 추측되는 대신 실패 폐쇄되어야 합니다. 중간 다운로드, 웹페이지 스냅샷, 생성된 코드, 검색 노트, 메모리와 같은 작업 노트 및 큰 추출된 텍스트는 Workspace/Action 참조로 유지되고 나중에 경계 재읽기를 통해 열릴 수 있습니다. 이러한 참조는 실행 증거이지 최종 결과물이 존재한다는 증거는 아닙니다. 발견된 URL, 경로, 다운로드 또는 스냅샷 참조는 해당 내용을 읽었다는 증거도 아닙니다. 경계 재읽기/콘텐츠 미리보기가 제공될 때까지ref_only로 처리하세요. 명시적content,excerpt또는snippet필드는 경계 미리보기일 뿐입니다.