Download the PHP package mftsoft/agent-runner without Composer
On this page you can find all versions of the php package mftsoft/agent-runner. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download mftsoft/agent-runner
More information about mftsoft/agent-runner
Files in mftsoft/agent-runner
Package agent-runner
Short Description Lightweight AI agent runner built on LLPhant with pluggable tools and skill support.
License MIT
Informations about the package agent-runner
AgentRunner
Biblioteca PHP leve para execução de agentes de IA com suporte a tools e skills plugáveis, construída sobre o LLPhant.
Requisitos
- PHP >= 8.1
- Extensão
curl - Composer
Instalação
Configuração
Crie um arquivo .env na raiz do projeto com as variáveis necessárias:
Uso básico
Opções do construtor
| Opção | Padrão | Descrição |
|---|---|---|
apiKey |
OPENAI_API_KEY do .env |
Chave da API OpenAI (ou compatível) |
url |
https://api.openai.com/v1/ |
URL base da API |
model |
gpt-4o-mini |
Modelo a ser utilizado |
systemPrompt |
Assistente genérico | Prompt de sistema base |
temperature |
1.0 |
Temperatura de geração |
maxIterations |
20 |
Limite de iterações do loop agêntico |
skillsPath |
<raiz-do-projeto>/skills |
Caminho para o diretório de skills |
Tools
Tools são classes de serviço que expõem métodos chamáveis pelo agente. Use ToolFactory::build() para registrá-las no runner.
Adicionando uma tool
A classe de serviço deve expor o método com o mesmo nome informado:
Sem tools
O runner funciona normalmente sem nenhuma tool registrada — o agente responde apenas com o conhecimento do modelo.
Skills
Skills são capacidades documentadas em arquivos Markdown. O agente as lê sob demanda e decide quando utilizá-las com base na tarefa do usuário.
Estrutura de diretórios
Formato do skill.md
O agente chama automaticamente a tool readSkill quando identifica que uma skill é relevante. A listagem das skills disponíveis é injetada no system prompt a cada sessão.
Caminho personalizado
API
AgentRunner
ToolFactory
SkillFactory
Compatibilidade com APIs OpenAI-compatíveis
O runner funciona com qualquer API compatível com o padrão OpenAI, como Ollama, Groq, OpenRouter, entre outras.
Licença
MIT — MFTSoft