README

This is the official PHP SDK for One.

Installation

Install the package via Composer:

composer require izzai/one-php

Quick Start

Authentication

Using Email and API Key

<?php

use Izzai\One\One;
use \Izzai\One\Types\OneAuthObjectType;

$one = new One(
  'YOUR_INSTANCE_ID',
  new OneAuthObjectType('YOUR_EMAIL_ID', 'YOUR_API_KEY')
);

Using JWT Token

<?php

use Izzai\One\One;

$one = new One('YOUR_INSTANCE_ID', 'JWT_TOKEN');

If you are using JWT token, make sure to check for the expiration time and refresh it as needed.

Basic Usage

Chat

use Izzai\One\Types\IChatBody;

// Simple chat [ defaults to AI message only ]
$response = $one->chat->chat('Hi there'); // Returns `Message`

// Get only the User message
$userResponse = $one->chat->chat('Hi there', IChatBody::from([]), 'user-message'); // Returns `Message`

// Get full conversation
$fullResponse = $one->chat->chat('Hi there', IChatBody::from([]), 'all'); // Returns `ChatWithMessages`

Chat with File

$response = $one->chat->chatWithFile(
  'Analyze this document',
  '/path/to/file.pdf',
  'document.pdf'  // optional filename
);

Advanced Chat Options

use Izzai\One\Types\IChatBody;

$response = $one->chat->chat(
  'Hello',
  IChatBody::from([
    'datasources' => ['datasource-id-1', 'datasource-id-2'],
    'tags' => ['tag1', 'tag2'],
  ])
);

Datasources

// List all datasources
$datasources = $one->datasource->list();

GPTs

// List all GPTs
$gpts = $one->gpt->list();

Agents

// List all agents
$agents = $one->agent->list();

Error Handling

The SDK throws exceptions for various error conditions:

try {
  $response = $one->chat->chat('Hello');
} catch (\InvalidArgumentException $e) {
  // Configuration or parameter errors
  echo "Configuration error: " . $e->getMessage();
} catch (\Exception $e) {
  // API or network errors
  echo "API error: " . $e->getMessage();
}

Requirements

• PHP 8.1 or higher
• Guzzle HTTP client (^7.0)
• JSON extension

License

MIT License. See the LICENSE file for details.