finding-agents

エージェントを探す

このスキルでは、同じ Letta サーバー上にいる他のエージェントを探せます。

このスキルを使う場面

• ユーザーが、自分の他のエージェントについて尋ねた場合
• ユーザーが、名前で特定のエージェントを探したい場合
• ユーザーが、特定のタグが付いたエージェントの一覧を表示したい場合
• メモリ移行に必要なエージェント ID を探す場合
• メッセージ検索で agent_id が見つかり、そのエージェントの詳細が必要な場合

CLI の使い方

letta agents list [options]

オプション

オプション	説明
--name <name>	名前が完全に一致するものを検索します
--query <text>	名前をあいまい検索します
--tags <tag1,tag2>	タグで絞り込みます（カンマ区切り）
--match-all-tags	すべてのタグを必須にします（デフォルトは ANY）
--include-blocks	レスポンスに agent.blocks を含めます
--limit <n>	結果の最大数（デフォルト：20）

よく使うパターン

Letta Code エージェントを探す

Letta Code で作成されたエージェントには、origin:letta-code タグが付いています。Letta Code エージェントのみを探すには、次のようにします。

letta agents list --tags "origin:letta-code"

ユーザーが Letta Code CLI のセッションで作業したエージェントを探している場合に便利です。

すべてのエージェントを探す

ユーザーが Letta Code 以外（ADE、SDK など）で作成したエージェントを持っている場合は、タグで絞り込まずに検索します。

letta agents list

例

すべてのエージェントを一覧表示します（最大20件）：

letta agents list

名前が完全に一致するエージェントを探します：

letta agents list --name "ProjectX-v1"

名前でエージェントをあいまい検索します：

letta agents list --query "project"

Letta Code エージェントのみを探します：

letta agents list --tags "origin:letta-code"

複数のタグが付いたエージェントを探します：

letta agents list --tags "frontend,production" --match-all-tags

結果にメモリブロックを含めます：

letta agents list --query "project" --include-blocks

出力

エージェントの詳細をすべて含む、生の API レスポンスを返します。主なフィールドは次のとおりです。

• id - エージェント ID（例：agent-abc123）
• name - エージェント名
• description - エージェントの説明
• tags - エージェントのタグ
• blocks - メモリブロック（--include-blocks を指定した場合）

関連スキル

• migrating-memory - エージェントを見つけたら、このスキルを使ってメモリブロックをコピーまたは共有します

トピックからエージェントを探す

特定のトピックに取り組んだエージェントを探す必要がある場合：

1. すべてのエージェントのメッセージを検索します：

   letta messages search --query "topic" --all-agents --limit 10
   

2. 一致したメッセージから agent_id の値を確認します
3. エージェントの詳細を取得します：

   letta agents list --query "partial-name"
   

   または、Letta API で agent_id を直接使用します