Download the PHP package swisnl/agents-sdk without Composer

On this page you can find all versions of the php package swisnl/agents-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of swisnl/agents-sdk

Informations about the package agents-sdk

Agents SDK for PHP

A lightweight yet powerful framework for building multi-agent workflows in PHP, inspired by the OpenAI Agents SDK.

PHP from Packagist Latest Version on Packagist Buy us a tree Build Status Made by SWIS

Overview

Agents SDK provides an elegant abstraction for creating AI agent systems in PHP, allowing you to:

The SDK is designed to be flexible, extensible, and easy to use while providing a robust foundation for building complex multi-agent based systems.

Installation

Basic Usage

Here's a simple example of creating and running an Agent that can use a Tool for retrieving weather information:

Creating Agents

Agents are the core components of the SDK. They encapsulate a specific role or capability and can use tools to perform actions.

Defining Tools

Tools are capabilities that agents can use to perform actions. To create a custom tool:

  1. Extend the Tool class
  2. Define parameters using attributes
  3. Implement the __invoke method with your tool's logic

MCP Tool Support

The SDK supports the Model Context Protocol (MCP) through the McpConnection class, allowing you to integrate external data sources and tools with your agents.

What is MCP?

MCP (Model Context Protocol) is an open protocol that enables seamless integration between LLM applications and external data sources and tools. It provides a standardized way to connect LLMs with the context they need, offering:

Using MCP

It's recommended to use the swis/mcp-client package for MCP client implementations.

To use MCP tools with your agents:

Advanced MCP Usage

The SDK supports advanced MCP features:

Example with a local MCP server:

Multi-Agent Systems

The SDK supports creating systems of specialized agents that can hand off tasks to each other:

Orchestration

The Orchestrator class manages the conversation flow and agent execution:

Observability

The SDK provides an observer pattern to monitor agent behavior:

Tracing

The SDK includes built-in tracing support using OpenAI Tracing format by default. This helps with debugging and monitoring agent execution.

Disabling Tracing

You can disable tracing in two ways:

  1. On a per-orchestrator basis:

  2. Globally via environment variable:

Disabling tracing can be useful in production environments or when you don't need the debugging information.

Example Implementations

The repository includes examples for common use cases:

Run the examples using:

Conversation Serialization

The SDK provides a way to serialize and deserialize conversation state, allowing you to continue conversations at a later time:

Requirements

Testing

The SDK includes a test suite built with PHPUnit. To run the tests:

Test Structure

Changelog

Please see CHANGELOG for more information on what has changed recently.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

This package is open-sourced software licensed under the MIT license.

This package is Treeware. If you use it in production, then we ask that you buy the world a tree to thank us for our work. By contributing to the Treeware forest you’ll be creating employment for local families and restoring wildlife habitats.

SWIS :heart: Open Source

SWIS is a web agency from Leiden, the Netherlands. We love working with open source software.

All versions of agents-sdk with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
ext-json Version *
openai-php/client Version ^0.10.3
psr/cache Version ^3.0
ramsey/uuid Version ^4.7
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package swisnl/agents-sdk contains the following files

Loading the files please wait ....