저는 여러 Laravel 애플리케이션에 상시 가동되는 Claude Code 에이전트를 추가해 왔습니다. 그 과정에서 항상 동일한 문제에 직면했습니다. 단일 비즈니스 운영(business operation)을 위해 Laravel AI, Laravel MCP, HTTP, Artisan, 그리고 큐(queues) 각각에 대해 별도의 구현을 해야 한다는 점이었습니다.

그래서 저는 laravel-agentic을 구축했고, 이를 오픈 소스로 공개하기로 했습니다. 이제 어떤 Laravel 앱을 만들더라도 즉시 에이전트 준비(agentic ready) 상태로 만들기 위해 이 라이브러리를 사용합니다 ;).

아이디어는 간단합니다. 액션(action)을 한 번만 정의하면, 필요한 모든 인터페이스를 통해 노출할 수 있습니다.

#[AgentAction(
    name: 'refund-invoice',
    needsApproval: true,
...

이 단일 정의는 이제 동일한 유효성 검사(validation), 권한 부여(authorization), 승인(approval), 그리고 감사(audit) 동작(tests/ParityTest.php에 이 다섯 가지 인터페이스가 모두 포함되어 있음)과 함께 다음과 같은 경로로 호출할 수 있습니다:

중요한 작업의 경우, needsApproval은 실행 전 권한이 부여된 액션을 일시 중지하고 사람의 동의를 기다립니다:

1. Laravel Agentic이 입력을 검증하고 authorize()를 실행합니다.
2. 승인이 필요한 경우, 승인 요청(approval request)을 생성하고 액션을 실행하기 전에 중단합니다.
3. 애플리케이션은 ApprovalRequested 이벤트를 처리하고 UI, Slack, 이메일 또는 기타 채널을 통해 요청을 전달합니다.
4. 승인 후:
   • Laravel AI는 자체 승인 시스템을 통해 일시 중지된 도구 호출(tool call)을 재개합니다.
   • MCP, HTTP, CLI 호출자는 동일한 주체(principal)와 인자(arguments)로 동일한 액션을 반복합니다.
5. 일회용 권한(single-use grant)이 소비되고 액션이 한 번 실행됩니다.

Laravel Agentic은 승인 상태, 인자 바인딩(argument binding), 만료(expiry), 강제 적용(enforcement) 및 감사 추적(audit trail)을 제공합니다. 여러분의 애플리케이션은 사람에게 보여지는 승인 채널을 제공하면 됩니다.

이 라이브러리는 laravel/ai, laravel/mcp, 그리고 spatie/laravel-data를 기반으로 구축되었습니다.

여러분의 의견을 알려주세요.

GitHub: https://github.com/gtapps/laravel-agentic