发现与选择智能体

查询当前工作区可见的智能体目录卡片,确认对象类型、状态与可用操作,并记录后续调用所需的智能体 ID 与所属工作区 ID。

任务流程

工作区客户端
    │
    ▼
分页查询智能体目录卡片
    │
    ▼
核对类型(agent)、状态与可用操作
    │
    ▼
保存智能体 ID 与所属工作区 ID

准备

  1. 已完成 使用 SDK 中的服务地址、个人访问令牌与工作区配置。

查询智能体目录卡片

运行以下示例列出当前工作区前 20 条目录卡片,输出每条记录的对象类型、所属工作区 ID、智能体 ID、名称、状态和可用动作。需要读取后续页时,在查询选项中传入 offset 继续翻页,直到已读数量达到 total 或返回空列表。

import os

import moi_product_sdk as sdk

client = sdk.new_with_personal_access_token(
    os.environ["PRODUCT_API_BASE_URL"],
    os.environ["PRODUCT_API_KEY"],
)
workspace_id = os.environ["WORKSPACE_ID"]
page = client.agents(workspace_id).list_agent_catalog_cards(
    sdk.with_query_param("limit", "20"),
    sdk.with_query_param("offset", "0"),
)
print("total:", page.total, "limit:", page.limit, "offset:", page.offset)
for card in page.items:
    print(
        card.kind,
        card.workspace_id,
        card.id,
        card.name,
        card.status,
        list(card.actions),
    )
package main

import (
	"context"
	"fmt"
	"log"
	"os"

	sdk "github.com/matrixorigin/matrixflow/sdk/go-sdk"
)

func main() {
	client, err := sdk.NewWithPersonalAccessToken(
		os.Getenv("PRODUCT_API_BASE_URL"),
		os.Getenv("PRODUCT_API_KEY"),
	)
	if err != nil {
		log.Fatal(err)
	}
	defer client.Close()

	page, err := client.Agents(os.Getenv("WORKSPACE_ID")).ListAgentCatalogCards(
		context.Background(),
		sdk.WithQueryParam("limit", "20"),
		sdk.WithQueryParam("offset", "0"),
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println("total:", page.GetTotal(), "limit:", page.GetLimit(), "offset:", page.GetOffset())
	for _, card := range page.GetItems() {
		fmt.Println(
			card.GetKind(),
			card.GetWorkspaceId(),
			card.GetId(),
			card.GetName(),
			card.GetStatus(),
			card.GetActions(),
		)
	}
}

目录中可能同时包含单智能体(agent)与团队条目,也可能包含系统来源条目。单智能体调用与版本维护应选择 kind 为 agent 的条目,并同时记录其 id 与 workspace_id。

下一步

最后更新于