安装 Agent SDK

安装你所用语言的 Agent SDK 包，设置 PHASEO_API_KEY，然后在用法中构建第一个智能体。每个包都会把该语言的 Phaseo 核心客户端作为依赖一起安装。

安装包

把 @phaseo/agent-sdk 0.3.0 安装到 TypeScript 或 JavaScript 项目中。@phaseo/sdk 会随之安装。

npm install @phaseo/agent-sdk

pnpm add @phaseo/agent-sdk

yarn add @phaseo/agent-sdk

bun add @phaseo/agent-sdk

把 phaseo-agent-sdk 0.3.0 安装到 Python 3.10 或更高版本的环境中。核心 phaseo 客户端（3.x）会随之安装，这个包以 phaseo_agent 模块的形式安装。

pip install phaseo-agent-sdk

uv add phaseo-agent-sdk

使用 Go 1.24 或更高版本添加 agent-sdk-go v0.3.0。Go 会把核心客户端 github.com/phaseoteam/Phaseo/packages/sdk/sdk-go/v3 添加为依赖。

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

以 phaseoagent 名称导入智能体包：

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

从 NuGet 添加 Phaseo.AgentSdk 0.3.0。你需要 .NET 8 或更高版本。NuGet 会把 Phaseo.Sdk 添加为依赖。

dotnet add package Phaseo.AgentSdk

智能体类型位于 PhaseoAgentSdk 命名空间中：

using PhaseoAgentSdk;

用 Composer 添加 phaseo/agent-sdk v0.3.0。你需要 PHP 8.1 或更高版本。Composer 会把 phaseo/sdk（^3.0.0）添加为依赖。

composer require phaseo/agent-sdk

智能体类位于 Phaseo\AgentSdk 命名空间中：

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

用 RubyGems 或 Bundler 添加 phaseo_agent_sdk 0.3.0。你需要 Ruby 3.2 或更高版本。RubyGems 会把 phaseo_sdk（>= 3.0.0, < 4.0.0）添加为依赖。

gem install phaseo_agent_sdk

gem "phaseo_agent_sdk"

用下面的代码加载智能体模块：

require "phaseo_agent_sdk"

从 Maven Central 添加 app.phaseo:phaseo-agent-sdk 0.3.0。你需要 Java 17 或更高版本。构建会把 app.phaseo:phaseo-sdk 3.0.0 和 Jackson 添加为依赖。所有类型都是 app.phaseo.agent.AgentSdk 中的嵌套 record。

<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")

如果要从源码构建：

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

使用 Rust 1.86 或更高版本，添加 crates.io 上的 phaseo-agent 和 phaseo 客户端，两者都是 0.2.0。与其他语言不同，你需要自己添加核心客户端。

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

cargo add phaseo@0.2 phaseo-agent@0.2 serde_json

设置你的 API 密钥

在 API 密钥中创建一个密钥，然后导出它：

export PHASEO_API_KEY="phaseo_v1_sk_..."

$env:PHASEO_API_KEY = "phaseo_v1_sk_..."

大多数网关客户端会从环境变量读取密钥，Python 的则不会。TypeScript、Python 和 Java 会忽略 PHASEO_BASE_URL：

语言	网关客户端	读取 `PHASEO_API_KEY`	读取 `PHASEO_BASE_URL`	在代码中传入的方式
TypeScript	`createGatewayAgentClient()`	是	否	`clientOptions.apiKey`、`clientOptions.baseUrl`
Python	`create_gateway_agent_client()`	否；没有密钥时抛出 `ValueError`	否	`client_options={"api_key": ...}` 或 `client=Phaseo()`
Go	`CreateGatewayAgentClient(...)`	是，在 `APIKey` 为空时	是，在 `BaseURL` 为空时	`GatewayAgentClientOptions.APIKey`、`.BaseURL`
C#	`AgentSdk.CreateGatewayAgentClient()`	是	是	`GatewayAgentClientOptions.ClientOptions` 中的 `apiKey`、`baseUrl`
PHP	`AgentSdk::createGatewayAgentClient()`	是	是	`GatewayAgentClientOptions::$clientOptions` 中的 `api_key`、`base_url`
Ruby	`PhaseoAgentSdk.create_gateway_agent_client`	是	是	`api_key:`、`base_url:`
Java	`AgentSdk.createGatewayAgentClient()`	是	否	`new AgentSdk.GatewayOptions(null, apiKey, baseUrl, null, null, null)`
Rust	`create_gateway_agent_client(model)`、`GatewayAgentClient::from_env(model)`	是	是，通过 `phaseo` 客户端	`GatewayAgentClient::new(client, model)`

默认的基础 URL 是 https://api.phaseo.app/v1。

检查安装

构建一个智能体但不调用模型。如果它能编译并运行，说明包已经安装好了：

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 没有简写形式：AgentDefinition 是一个按位置传参的 record，完整写法见用法。

从这里开始

构建

观察

参考