Installation du SDK Agent

Installez le package SDK Agent de votre langage, définissez PHASEO_API_KEY et construisez un premier agent dans Utilisation. Chaque package apporte en dépendance le client Phaseo principal de son langage.

Installer le package

Installez @phaseo/agent-sdk 0.3.0 dans un projet TypeScript ou JavaScript. @phaseo/sdk est installé avec lui.

npm install @phaseo/agent-sdk

pnpm add @phaseo/agent-sdk

yarn add @phaseo/agent-sdk

bun add @phaseo/agent-sdk

Installez phaseo-agent-sdk 0.3.0 dans un environnement Python 3.10 ou plus récent. Le client principal phaseo (3.x) est installé avec lui, et le package s’installe sous le nom de module phaseo_agent.

pip install phaseo-agent-sdk

uv add phaseo-agent-sdk

Ajoutez agent-sdk-go v0.3.0 avec Go 1.24 ou plus récent. Go ajoute le client principal, github.com/phaseoteam/Phaseo/packages/sdk/sdk-go/v3, en dépendance.

go get github.com/phaseoteam/Phaseo/packages/sdk/agent-sdk-go@latest

Importez le package de l’agent sous le nom phaseoagent :

import phaseoagent "github.com/phaseoteam/Phaseo/packages/sdk/agent-sdk-go"

Ajoutez Phaseo.AgentSdk 0.3.0 depuis NuGet. Il vous faut .NET 8 ou plus récent. NuGet ajoute Phaseo.Sdk en dépendance.

dotnet add package Phaseo.AgentSdk

Les types de l’agent se trouvent dans l’espace de noms PhaseoAgentSdk :

using PhaseoAgentSdk;

Ajoutez phaseo/agent-sdk v0.3.0 avec Composer. Il vous faut PHP 8.1 ou plus récent. Composer ajoute phaseo/sdk (^3.0.0) en dépendance.

composer require phaseo/agent-sdk

Les classes de l’agent se trouvent dans l’espace de noms Phaseo\AgentSdk :

use Phaseo\AgentSdk\AgentDefinition;
use Phaseo\AgentSdk\AgentSdk;
use Phaseo\AgentSdk\Tool;

Ajoutez phaseo_agent_sdk 0.3.0 avec RubyGems ou Bundler. Il vous faut Ruby 3.2 ou plus récent. RubyGems ajoute phaseo_sdk (>= 3.0.0, < 4.0.0) en dépendance.

gem install phaseo_agent_sdk

gem "phaseo_agent_sdk"

Chargez le module de l’agent avec :

require "phaseo_agent_sdk"

Ajoutez app.phaseo:phaseo-agent-sdk 0.3.0 depuis Maven Central. Il vous faut Java 17 ou plus récent. Le build ajoute app.phaseo:phaseo-sdk 3.0.0 et Jackson en dépendances. Tous les types sont des records imbriqués dans app.phaseo.agent.AgentSdk.

<dependency>
  <groupId>app.phaseo</groupId>
  <artifactId>phaseo-agent-sdk</artifactId>
  <version>0.3.0</version>
</dependency>

implementation("app.phaseo:phaseo-agent-sdk:0.3.0")

Pour compiler depuis les sources à la place :

git clone https://github.com/phaseoteam/Phaseo.git
cd Phaseo
mvn -f packages/sdk/agent-sdk-java/pom.xml package

Ajoutez phaseo-agent et le client phaseo, tous deux en 0.2.0 sur crates.io, avec Rust 1.86 ou plus récent. Contrairement aux autres langages, ajoutez vous-même le client principal.

[dependencies]
phaseo = "0.2"
phaseo-agent = "0.2"
serde_json = "1"

cargo add phaseo@0.2 phaseo-agent@0.2 serde_json

Définir votre clé API

Créez une clé dans Clés API, puis exportez-la :

export PHASEO_API_KEY="phaseo_v1_sk_..."

$env:PHASEO_API_KEY = "phaseo_v1_sk_..."

La plupart des clients gateway lisent la clé dans l’environnement ; celui de Python ne le fait pas. TypeScript, Python et Java ignorent PHASEO_BASE_URL :

Langage	Client gateway	Lit `PHASEO_API_KEY`	Lit `PHASEO_BASE_URL`	Passez-les dans le code avec
TypeScript	`createGatewayAgentClient()`	Oui	Non	`clientOptions.apiKey`, `clientOptions.baseUrl`
Python	`create_gateway_agent_client()`	Non ; lève `ValueError` sans clé	Non	`client_options={"api_key": ...}` ou `client=Phaseo()`
Go	`CreateGatewayAgentClient(...)`	Oui, quand `APIKey` est vide	Oui, quand `BaseURL` est vide	`GatewayAgentClientOptions.APIKey`, `.BaseURL`
C#	`AgentSdk.CreateGatewayAgentClient()`	Oui	Oui	`apiKey`, `baseUrl` dans `GatewayAgentClientOptions.ClientOptions`
PHP	`AgentSdk::createGatewayAgentClient()`	Oui	Oui	`api_key`, `base_url` dans `GatewayAgentClientOptions::$clientOptions`
Ruby	`PhaseoAgentSdk.create_gateway_agent_client`	Oui	Oui	`api_key:`, `base_url:`
Java	`AgentSdk.createGatewayAgentClient()`	Oui	Non	`new AgentSdk.GatewayOptions(null, apiKey, baseUrl, null, null, null)`
Rust	`create_gateway_agent_client(model)`, `GatewayAgentClient::from_env(model)`	Oui	Oui, via le client `phaseo`	`GatewayAgentClient::new(client, model)`

L’URL de base par défaut est https://api.phaseo.app/v1.

Vérifier l’installation

Construisez un agent sans appeler le modèle. Si ce code compile et s’exécute, le package est installé :

import { createAgent } from "@phaseo/agent-sdk";

createAgent({ id: "verification-agent", model: "openai/gpt-6-astra" });
console.log("Phaseo Agent SDK installed");

from phaseo_agent import create_agent

create_agent({"id": "verification-agent", "model": "openai/gpt-6-astra"})
print("Phaseo Agent SDK installed")

package main

import (
  "fmt"

  phaseoagent "github.com/phaseoteam/Phaseo/packages/sdk/agent-sdk-go"
)

func main() {
  phaseoagent.CreateAgent(phaseoagent.AgentDefinition{ID: "verification-agent", Model: "openai/gpt-6-astra"})
  fmt.Println("Phaseo Agent SDK installed")
}

using PhaseoAgentSdk;

AgentSdk.CreateAgent(new AgentDefinition { Id = "verification-agent", Model = "openai/gpt-6-astra" });
Console.WriteLine("Phaseo Agent SDK installed");

<?php
require "vendor/autoload.php";

use Phaseo\AgentSdk\AgentDefinition;
use Phaseo\AgentSdk\AgentSdk;

AgentSdk::createAgent(new AgentDefinition(id: "verification-agent", model: "openai/gpt-6-astra"));
echo "Phaseo Agent SDK installed" . PHP_EOL;

require "phaseo_agent_sdk"

PhaseoAgentSdk.create_agent(id: "verification-agent", model: "openai/gpt-6-astra")
puts "Phaseo Agent SDK installed"

use phaseo_agent::{create_agent, AgentDefinition};

fn main() {
    let _agent = create_agent(AgentDefinition::new(
        "verification-agent",
        "openai/gpt-6-astra",
    ));
    println!("Phaseo Rust Agent SDK installed");
}

Java n’a pas de forme courte : AgentDefinition est un record positionnel, présenté en entier dans Utilisation.

Commencez ici

Développer

Observabilité

Référence

Installation du SDK Agent