Agentspan 프로세스 충돌, 배포, 오랜 대기 및 인간 승인을 견뎌야 하는 작업을 수행하는 AI 에이전트를 위한 오픈 소스 실행 계층입니다. 전체 에이전트 루프를 애플리케이션 메모리에 유지하는 대신 Agentspan 서버에 실행 상태를 저장하고 도구 작업을 연결된 작업자에게 위임합니다. 이 프로젝트는 Conductor 워크플로 엔진에서 Orkes에 의해 구축되었으며 현재 MIT 라이선스를 취득했으며 자체 호스팅이 가능합니다.
구별이 중요합니다. Agentspan은 약한 에이전트를 지능적으로 만들거나 안전한 권한을 선택하거나 비즈니스 결과를 검증하지 않습니다. 실패 모델을 변경합니다. 실행은 지속 가능한 ID를 얻고, 완료된 단계에는 기록이 있으며, 보류 중인 승인은 서버 측에서 기다릴 수 있으며, 교체 작업자는 다시 연결할 수 있습니다. 팀은 이를 프롬프트 라이브러리가 아닌 분산 시스템 인프라로 평가해야 합니다.
상태가 에이전트 프로세스 외부로 이동할 때 변경되는 사항
| 우려 | 처리 중인 에이전트 루프 | Agentspan 모델 | 운영자는 여전히 소유하고 있습니다. |
|---|---|---|---|
| 프로세스 충돌 | 메모리 및 현재 위치가 사라질 수 있습니다. | 서버는 워크플로 상태를 유지하고 작업을 재개합니다. | 작업자 가용성 및 멱등성 도구 |
| 인간의 승인 | 애플리케이션은 보류 상태를 유지하거나 다시 작성해야 합니다. | 워크플로는 서버 측을 일시 중지하고 나중에 응답을 받을 수 있습니다. | 승인자 신원, 시간 초과 및 에스컬레이션 정책 |
| 재시도 | 사용자 정의 루프, 종종 거칠게 구성됨 | 단계별 재시도는 워크플로 기본 요소입니다. | 재시도 가능한 오류와 부작용이 안전한지 여부 |
| 역사 | 애플리케이션별 로그 | 입력, 출력, 타이밍 및 단계를 쿼리할 수 있습니다. | 수정, 보존 및 액세스 제어 |
| 규모 | 하나의 프로세스에 결합된 상태 및 스케줄링 | 서버는 작업자와 실행을 조정합니다. | 용량, 테넌시, 대기열 및 재해 복구 |
| 스케줄링/이벤트 | 별도의 cron 또는 메시지 배관 | Conductor 일정 및 이벤트 통합 | 중복, 중복 제거 및 이벤트 누락 동작 |
실패 경계로 그려진 런타임 경로
사용자/이벤트
|
v
.---------. 내구성 상태 ---------.
| 애플리케이션 코드 | -----------> | Agentspan / Conductor|
| 에이전트 + 도구 | <--- task delegation ---- | run, step, history |
'--------------------' '----------+-----------'
| worker may die |
| and reconnect | calls
v v
custom tool process LLM / HTTP / MCP tools
| |
'---------------- results + side effects ---------------'
Durable checkpoint ≠ transaction over every external side effect
마지막 줄은 가장 중요한 운영상의 주의 사항입니다. 워크플로 엔진은 결제, 이메일 또는 저장소 변경을 요청했음을 기억할 수 있지만 자동으로 임의의 외부 작업을 트랜잭션으로 만들 수는 없습니다. 작업자가 원격으로 성공하고 완료를 확인하기 전에 충돌이 발생하는 경우 재시도를 통해 작업이 반복될 수 있습니다. 모든 돌연변이 도구에는 멱등성 키, 조정 쿼리 또는 사람의 결정 경로가 필요합니다.
Happy-Path 데모 전에 충돌 테스트를 수행하십시오.
유용한 개념 증명은 의도적으로 다양한 경계에서 작업자를 죽입니다. 읽기 전용 연구 작업 1개, 부작용이 통제된 작업 1개, 승인 제한 작업 1개를 실행합니다. 실행 ID를 유지하고, 다른 머신에서 다시 시작한 후, 다시 연결하고, 중단 없는 제어 실행과 최종 상태를 비교합니다.
| 주입점 | 예상되는 증거 | 출시를 차단해야 하는 실패 |
|---|---|---|
| LLM 요청 중 | 제한된 재시도 및 하나의 일관된 연속 | 무제한 토큰 지출 또는 중복된 컨텍스트 |
| 읽기 전용 도구 완료 후 | 이전 결과를 잃지 않고 재개 | 실행이 처음부터 다시 시작됩니다. |
| 원격 쓰기 후, 승인 전 | 멱등성 키는 중복을 방지합니다. | 티켓 2개, 결제, 메시지 또는 커밋 |
| 승인을 기다리는 동안 | 다시 시작하면 보류 중인 요청 및 감사 ID가 유지됩니다. | 암시적 승인, 요청 손실 또는 잘못된 승인자 |
| 배포 중 | 이전 작업자와 새 작업자는 동일한 배타적 단계를 실행하지 않습니다. | 분할 두뇌 부작용 |
| 서버 재시작 후 | 문서화된 복구 목표가 충족되었습니다. | 기록 또는 워크플로 상태를 복구할 수 없습니다. |
재시도에는 부작용 계약이 필요합니다.
자동 재시도를 활성화하기 전에 도구를 분류하세요. 순수 기능과 반복 가능한 읽기는 일반적으로 재시도할 수 있습니다. 쓰기에는 워크플로 및 단계에 맞는 안정적인 작업 키가 필요합니다. 반복할 수 없는 작업에는 "재시도 전 쿼리" 어댑터나 수동 조정 대기열이 필요합니다. LLM에게 대화 내용을 통해 결제 또는 메시지가 이미 발생했는지 추론하도록 요청하지 마세요.
- 안전한 재시도: 체크섬을 계산하고, 공개 페이지를 읽거나 변경할 수 없는 ID로 쿼리합니다.
- 조건부 안전: 서버 적용 멱등성 키로 티켓을 생성하거나 버전 확인을 통해 알려진 레코드를 업데이트하세요.
- 기본적으로 안전하지 않음: 중복 제거 없이 이메일을 보내고, 콘텐츠를 게시하고, 송금하거나, 프로덕션 변경을 실행할 수 있습니다.
- 보상 대상: 테스트된 취소 작업과 책임 있는 에스컬레이션 경로가 존재하는 경우 리소스를 예약합니다.
사람의 승인은 일시 정지 버튼이 아닌 정책 시스템입니다.
Agentspan은 승인 및 CLI, API 또는 UI 응답용으로 표시된 도구를 문서화합니다. 프로덕션 정책은 승인할 수 있는 사람, 고정된 정확한 인수, ID 인증 방법, 요청이 만료되는 시기 및 수정된 작업이 새 승인을 생성하는지 여부를 추가로 정의해야 합니다. 승인자에게 제안된 부작용, 대상, 데이터 공개, 예상 비용 및 사람이 읽을 수 있는 차이점을 보여줍니다.
영향력이 큰 작업의 경우 요청자와 승인자를 분리하세요. 거부는 조치를 종료하거나 범위를 좁혀야 합니다. 모델이 다른 도구를 사용하여 게이트 주위를 라우팅하도록 유도해서는 안 됩니다. 재생 시 이전 결정을 새 인수에 적용할 수 없도록 실행과 함께 정책 버전 및 승인 아티팩트를 기록합니다.
프레임워크 호환성은 동일한 의미를 의미하지 않습니다.
공식 문서는 자체 에이전트 API과 LangGraph, OpenAI 에이전트 SDK 및 Google ADK와의 통합을 보여줍니다. 배포하려는 정확한 어댑터와 버전을 테스트하세요. 스트리밍, 취소, 중첩된 에이전트, 도구 호출 ID, 구조화된 출력, 컨텍스트 전파 및 오류 매핑을 확인하세요. 래퍼는 체크포인트나 재시도 동작을 변경하는 동안 호출 가능한 인터페이스를 유지할 수 있습니다.
| 통합 선택 | 그것을 사용하는 가장 좋은 이유 | 검증 질문 |
|---|---|---|
| 기본 Agentspan 에이전트 | 가장 작은 개념적 표면과 문서화된 기본 요소 | 모델/도구 추상화가 필요한 동작을 포괄합니까? |
| LangGraph | 기존 그래프, 노드 및 상태 설계 | 체크포인트, 재시도 및 인터럽트를 소유하는 레이어는 무엇입니까? |
| OpenAI 상담원 SDK | 기존 에이전트, 핸드오프 및 추적 규칙 | 도구 및 승인 이벤트가 손실 없이 매핑됩니까? |
| 구글 ADK | 기존 Google 에이전트 구현 | 세션 상태와 아티팩트가 지속적으로 표시됩니까? |
| HTTP/OpenAPI 도구 | 사용자 정의 작업자 코드가 없는 서버측 호출 | 자격 증명, 속도 제한 및 응답 스키마는 어디에 적용됩니까? |
| MCP 도구 | MCP 서버의 기능 표면 재사용 | 노출된 각 메서드의 범위를 지정하고 독립적으로 감사할 수 있나요? |
자격 증명 및 저장된 실행 데이터
Agentspan은 환경 구성 및 서버 실행 HTTP, OpenAPI 및 MCP 도구를 통해 공급자 키를 지원합니다. 중앙 실행은 모든 작업자에게 복사되는 비밀을 줄일 수 있지만 동시에 권한을 집중시킵니다. Secret Manager, 단기 자격 증명, 환경별 ID 및 아웃바운드 허용 목록을 사용하세요. 프롬프트, 도구 스키마 또는 지속된 결과 내에 자격 증명을 배치하지 마십시오.
실행 기록에는 고객 텍스트, 검색된 문서, 소스 코드, 모델 응답, 도구 인수 및 오류가 포함될 수 있습니다. 스토리지 전에 수정되는 필드, 검색 또는 재생 실행이 가능한 사람, 테넌트 분리 방법, 삭제 요청이 백업 및 관찰 가능성 내보내기에 전파되는 방법을 결정합니다. 지속성이 복구 가능성과 동일하다고 가정하는 대신 전송 및 저장을 암호화하고, 읽기 액세스를 감사하고, 복원을 테스트합니다.
행동으로 이어지는 관찰 가능성
원시 추적은 운영 관련 질문에 답하는 경우에만 유용합니다. 트리거, 워크플로, 모델 호출 및 외부 변형 전반에 걸쳐 상관 관계 ID를 연결합니다. 모델/버전, 프롬프트 정책 버전, 토큰 수, 도구 대기 시간, 재시도 이유, 승인 지연 및 단말기 분류를 기록합니다. 라벨에 카디널리티가 높은 비밀을 사용하지 마세요.
| 미터법 | 왜 중요한가요? | 제안된 알림 |
|---|---|---|
| 성공적인 비즈니스 성과 | 완료된 워크플로와 올바른 결과를 분리합니다. | 작업별 기준선 대비 하락 |
| 중복된 부작용 | 손상된 멱등성을 감지합니다. | 중요한 도구에 대해 확인된 중복 항목 |
| 단계당 재시도 | 불안정한 도구와 숨겨진 비용을 찾아냅니다. | 도구/버전별 지속적인 증가 |
| 승인 연령 | 정체된 작업 및 운영 부담을 보여줍니다. | 과거 정책 SLA 또는 만료 |
| 복구 성공 | 코어 내구성 약속을 측정합니다. | 복구할 수 없는 모든 적격 실행 |
| 허용된 결과당 비용 | 모델, 컴퓨팅 및 검토자 비용을 결합합니다. | 회귀 및 제어 워크플로 |
배포 및 업그레이드 체크리스트
- SDK, 서버 및 Conductor 버전을 고정합니다. 호환성 매트릭스를 기록하십시오.
- 별도의 개발, 스테이징 및 프로덕션 자격 증명, 대기열 및 데이터 저장소.
- 워크플로우 메타데이터를 백업하고 격리된 환경으로의 복원을 테스트합니다.
- 에이전트 및 테넌트별로 동시성, 토큰, 시간, 재시도 및 재귀 예산을 설정합니다.
- 서버, 작업자, 대기열, 데이터베이스 및 모델 공급자에 대한 상태 확인을 구성합니다.
- 업그레이드를 위해 카나리아 작업자를 사용하고 진행 중인 실행에 사용할 수 있는 이전 워크플로 정의를 유지합니다.
- 취소 의미 체계 정의: 향후 작업을 중지하고 자격 증명을 취소하며 부분적인 부작용을 조정합니다.
- 위협 모델 프롬프트 주입, SSRF, 악성 도구 출력 및 지나치게 광범위한 MCP/OpenAPI 노출.
대안과 정직한 선택 경계
| 옵션 | 이럴 때 선택하세요 | 트레이드오프 |
|---|---|---|
| Agentspan | Conductor에 대한 에이전트별 API, 자체 호스팅 및 통합을 원합니다. | 새로운 제어 평면과 진화하는 프로젝트 표면 |
| LangGraph 지속성 | 귀하의 애플리케이션은 이미 깊은 그래프 형태입니다. | 더 많은 프로덕션 오케스트레이션 옵션을 보유하고 있습니다. |
| 일시적 | 조직은 이미 대규모로 내구성 있는 워크플로를 운영하고 있습니다. | 에이전트 어댑터 및 재생 안전 코드에는 엔지니어링이 필요합니다. |
| Conductor 직접 | 에이전트 이외의 일반적인 워크플로 기본 요소가 필요합니다. | 에이전트별 편의성 감소 |
| 재설명 또는 DBOS 패턴 | 애플리케이션 코드에 가까운 내구성 있는 기능/트랜잭션을 원합니다. | 다양한 생태계 및 통합 모델 |
| 대기열 + 데이터베이스 상태 머신 | 작업 흐름이 작고 결정적이며 안정적입니다. | 종속성 수가 가장 낮지만 사용자 지정 복구 및 UI 작업 |
| 관리형 에이전트 플랫폼 | 인프라 제어보다 빠른 운영이 더 중요 | 공급업체, 데이터 및 맞춤화 제약 |
워크플로에서 LLM을 사용한다는 이유만으로 내구성 있는 런타임을 추가하지 마세요. 부작용이 없는 짧은 동기 어시스턴트는 요청 로깅 및 재시도만 필요할 수 있습니다. Agentspan은 실행 시간이 길거나, 승인이 프로세스 수명을 초과하거나, 이벤트가 작업을 트리거하거나, 복구 기록이 제품 요구 사항인 경우에 강력해집니다.
2주 평가 계획
첫 번째 주에는 제어 워크플로우와 통합을 구축해야 합니다. 3~10단계, 1회 승인 및 취소 가능한 외부 쓰기가 포함된 제한된 작업 1개를 선택하세요. 중단 없는 성공과 비용을 측정한 다음 충돌을 주입합니다. 2주차에는 중복 이벤트, 승인 지연, 잘못된 도구 출력, 공급자 비율 제한, 작업자 교체, 서버 다시 시작 및 진행 중인 실행을 통한 업그레이드 등 적대적이고 운영적인 사례에 초점을 맞춰야 합니다.
다른 엔지니어가 서면 지침에 따라 배포 및 복구를 재현할 수 있고, 모든 변형 도구에 테스트된 부작용 정책이 있으며, 중요한 기록이 관리되고, 승인된 결과 비율이 서버 및 통화 중 부담을 정당화할 만큼 충분히 향상되는 경우에만 승격하세요.
자주 묻는 질문
Agentspan은 에이전트 프레임워크인가요?
여기에는 에이전트 API이 포함되어 있지만 에이전트의 지속 가능한 런타임이 차별화됩니다. 또한 지원되는 외부 프레임워크로 구축된 에이전트를 실행할 수도 있습니다.
실행 엔진이란 무엇입니까?
프로젝트에서는 에이전트 정의가 내구성 있는 상태, 기록, 재시도 및 워크플로 기본 요소를 제공하는 Conductor의 워크플로로 컴파일된다고 명시합니다.
자체 호스트가 가능한가요?
그렇습니다. 공식 사이트에서는 이를 MIT 라이센스가 있고 자체 호스팅이 가능하다고 설명합니다. 운영자는 여전히 종속성, 데이터 저장소, 업그레이드 및 지원 기대치를 검증해야 합니다.
충돌 복구는 중복 쓰기를 방지합니까?
아니요. 내구성 있는 오케스트레이션은 손실된 상태를 줄이지만 외부 쓰기에는 여전히 멱등성, 조정 또는 보상이 필요합니다.
승인은 자동으로 보호되나요?
아니요. 팀은 인증, 권한 부여, 인수 바인딩, 만료, 업무 분리 및 감사 보존을 정의해야 합니다.
에이전트 프레임워크가 필요하지 않나요?
아니요. 기존 에이전트 정의를 보완할 수 있습니다. 충돌하는 의미를 피하기 위해 상태, 재시도 및 인터럽트에 대해 하나의 명확한 소유자를 선택하십시오.
첫 번째 프로덕션 워크로드는 무엇이어야 합니까?
결제, 생산 변경 또는 광범위한 데이터 액세스가 아닌 측정 가능한 성공과 명확한 에스컬레이션을 제공하는 제한적이고 되돌릴 수 있으며 민감도가 낮은 워크플로입니다.
1차 소스
- 공식 Agentspan 사이트 및 빠른 시작
- 공식 문서
- 공식 아키텍처 및 내구성 설명
- 에이전트 실행 개념
- 도구 유형 및 서버 측 실행
- 지원되는 모델 공급자 및 구성
- CLI, 승인 및 실행 내역
- 공식 소스 저장소
- LLM 지원 위험에 대한 OWASP 지침
2026년 7월 25일에 최종 검토되었습니다. Agentspan은(는) 빠르게 발전하고 있습니다. 채택하기 전에 정확한 SDK/서버 릴리스, 라이선스, 프레임워크 어댑터 및 배포 지침을 확인하세요.
