memória do agente uip

Anexe, liste e remova espaços de memória e itens de memória em um agente de pouco código com "memória do agente uip".

uip agent memory gerencia as funcionalidades de espaço de memória anexadas a um agente: um espaço de memória é uma fonte de recall aumentada por recuperação (memória episódica ou de escalonamento) que o agente pode pesquisar no runtime. uip agent memory item gerencia itens individuais de chave/valor semeados em um espaço de memória configurado.

Somente local — sem necessidade de login.

Resumo

uip agent memory add    <name> --memory-space <name> --folder-path <path> [--reference-key <key>] [--description <desc>] [--threshold <n>] [--result-count <n>] [--search-mode <hybrid|semantic>] [--field <name=weight>]... [--disable-dynamic-few-shot] [--path <dir>]
uip agent memory list                                                                                                                                                                                                                            [--path <dir>]
uip agent memory remove <name> [--folder-path <path>]                                                                                                                                                                                             [--path <dir>]

uip agent memory item add    <name> <key> <value> --memory-type <episodic|escalation> [--folder-path <path>] [--description <desc>] [--metadata <json>] [--path <dir>]
uip agent memory item list   <name> [--folder-path <path>]                                                                                                                                                                                        [--path <dir>]
uip agent memory item remove <name> <key> [--folder-path <path>]                                                                                                                                                                                  [--path <dir>]

Todas as invocações honram as opções globais (--output, --output-filter, --log-level, --log-file). Os códigos de saída seguem o contrato padrão.

adição de memória do agente uip

Anexe um espaço de memória ao agente.

Argumentos

• <name> (necessário) — Nome da funcionalidade a ser usada no agente.

Opções

Bandeira	Padrão	Required	Finalidade
--memory-space <name>	—	sim	Nome do espaço de memória a ser anexado.
--folder-path <path>	—	sim	Caminho da pasta onde existe o espaço de memória.
--reference-key <key>	—		Chave de recurso da solução de espaço da memória.
--description <desc>	—		Descrição do espaço de memória.
--threshold <n>	0		Limite de pontuação de recuperação.
--result-count <n>	3		Número de resultados a serem recuperados (inteiro positivo).
--search-mode <mode>	hybrid		hybrid ou semantic.
--field <name=weight>	—		Peso do campo de entrada. Repetível.
--disable-dynamic-few-shot	desativada		Anexe o espaço de memória sem habilitar a recuperação dinâmica de poucos exemplos (habilitado por padrão).
--path <path>	.		Caminho para o diretório do projeto do agente.

Exemplo

uip agent memory add SupportRecall --memory-space customer-support-recall --folder-path Shared --path ./my-agent

Formato dos dados (--output json)

{
  "Code": "AgentMemoryAdd",
  "Data": {
    "Status": "Memory space added",
    "Name": "SupportRecall",
    "MemorySpace": "customer-support-recall",
    "FolderPath": "Shared",
    "DynamicFewShotEnabled": true,
    "Id": "a1b2c3d4-0000-0000-0000-000000000070"
  }
}

lista de memória de agentes uip

Opções

Bandeira	Padrão	Finalidade
--path <path>	.	Caminho para o diretório do projeto do agente.

Exemplo

uip agent memory list --path ./my-agent

Formato dos dados (--output json)

{
  "Code": "AgentMemoryList",
  "Data": [
    { "Name": "SupportRecall", "MemorySpace": "customer-support-recall", "FolderPath": "Shared", "DynamicFewShotEnabled": true, "Id": "a1b2c3d4-0000-0000-0000-000000000070" }
  ]
}

remoção de memória do agente uip

Argumentos

• <name> necessário) — Nome da funcionalidade, nome do espaço de memória ou ID a remover.

Opções

Bandeira	Finalidade
--folder-path <path>	Caminho da pasta, ao remover por nome do espaço da memória.
--path <path>	Caminho para o diretório do projeto do agente (padrão .).

Exemplo

uip agent memory remove SupportRecall --path ./my-agent

Formato dos dados (--output json)

{ "Code": "AgentMemoryRemove", "Data": { "Status": "Memory space removed", "Name": "SupportRecall" } }

Um espaço de memória não encontrado por nome/ID falha no comando com um código de saída diferente de zero.

adição de item de memória do agente uip

Adicione um item de memória a um espaço de memória configurado.

Argumentos

Name	Required	Finalidade
<name>	sim	Nome da funcionalidade, nome do espaço de memória ou ID.
<key>	sim	Chave do item de memória.
<value>	sim	Valor do item da memória.

Opções

Bandeira	Required	Finalidade
--folder-path <path>		Caminho da pasta, ao selecionar pelo nome do espaço da memória.
--memory-type <type>	sim	episodic (0) ou escalation (1) — valores numéricos 0/1 também aceitos.
--description <desc>		Descrição do item de memória.
--metadata <json>		Metadados de item de memória como um objeto JSON.
--path <path>		Caminho para o diretório do projeto do agente (padrão .).

Exemplos

uip agent memory item add SupportRecall customer-tier gold --memory-type episodic --metadata '{"source":"seed"}' --path ./my-agent

uip agent memory item add SupportRecall escalation-case pending --memory-type escalation --path ./my-agent

Formato dos dados (--output json)

{
  "Code": "AgentMemoryItemAdd",
  "Data": { "Status": "Memory item added", "Memory": "SupportRecall", "Key": "customer-tier", "MemoryType": 0, "Id": "a1b2c3d4-0000-0000-0000-000000000080" }
}

lista de itens de memória do agente uip

Argumentos

• <name> necessário) — Nome da funcionalidade, nome do espaço de memória ou ID.

Opções

Bandeira	Finalidade
--folder-path <path>	Caminho da pasta, ao selecionar pelo nome do espaço da memória.
--path <path>	Caminho para o diretório do projeto do agente (padrão .).

Exemplo

uip agent memory item list SupportRecall --path ./my-agent

Formato dos dados (--output json)

{
  "Code": "AgentMemoryItemList",
  "Data": [
    { "Key": "customer-tier", "Value": "gold", "MemoryType": 0, "Description": null, "Metadata": { "source": "seed" }, "Id": "a1b2c3d4-0000-0000-0000-000000000080" }
  ]
}

item de memória do agente uip remover

Argumentos

Name	Required	Finalidade
<name>	sim	Nome da funcionalidade, nome do espaço de memória ou ID.
<key>	sim	Chave ou ID do item de memória a ser removido.

Opções

Bandeira	Finalidade
--folder-path <path>	Caminho da pasta, ao selecionar pelo nome do espaço da memória.
--path <path>	Caminho para o diretório do projeto do agente (padrão .).

Exemplo

uip agent memory item remove SupportRecall customer-tier --path ./my-agent

Formato dos dados (--output json)

{ "Code": "AgentMemoryItemRemove", "Data": { "Status": "Memory item removed", "Memory": "SupportRecall", "Key": "customer-tier" } }

Relacionado

• uip agent validate — executar novamente após editar a configuração de memória.
• uip agent refresh — regenera arquivos derivados após um espaço de memória ser adicionado.

Veja também

• Opções globais, Códigos de saída.