快速开始

最小可用的程序：从 ACL 文件创建一个 agent，在项目目录上打开会话，使用 send 运行一轮对话，打印回复文本，并查看运行时为该轮生成的验证摘要。

Rust

Node.js

Python

Rust

use a3s_code_core::Agent;

#[tokio::main]
async fn main() -> a3s_code_core::Result<()> {
    // Agent::new 接受 .acl 文件路径或内联 ACL 源文本。
    let agent = Agent::new("agent.acl").await?;
    let session = agent.session_builder(".").build().await?;

    let result = session.send("列出当前目录中的文件。", None).await?;
    println!("{}", result.text);

    // 运行时在生成这个回合时执行的验证。
    println!("{}", result.verification_summary_text());

    session.close().await;
    agent.close().await;
    Ok(())
}

TypeScript

import { Agent } from '@a3s-lab/code';

// Agent.create 接受 .acl 文件路径或内联 ACL 字符串。
const agent = await Agent.create('agent.acl');
const session = agent.session('.');

const result = await session.send('List the files in this directory.');
console.log(result.text);

// 运行时在生成这个回合时执行的验证。
console.log(result.verificationSummaryText);

session.close();

package main

import (
	"context"
	"fmt"
	"log"

	code "github.com/A3S-Lab/Code/sdk/go/v6"
)

func main() {
	ctx := context.Background()
	agent, err := code.Create(ctx, "agent.acl")
	if err != nil {
		log.Fatal(err)
	}
	defer agent.Close(context.Background())

	session, err := agent.Session(ctx, ".", nil)
	if err != nil {
		log.Fatal(err)
	}
	defer session.Close(context.Background())

	result, err := session.Run(ctx, "列出当前目录中的文件。")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(result.Text)
	fmt.Println(result.VerificationSummaryText)
}

四种 SDK 的 Agent 工厂都接收 .acl 文件路径或内联 ACL 源文本。使用完毕后，请务必关闭 Session，让 Runtime 刷新状态并释放资源。Go 的关闭操作接收 Context，因为它还需要停止桥接程序持有的原生资源。

下一步

流式输出 — 在 token 到达时实时读取
会话 — 持久化并恢复对话

#快速开始

#下一步

快速开始

下一步