Tablestore:Build Wiki

Pré-requisitos

• É necessário ter um AgentStorage instance criado e no estado normal, além de possuir o endpoint e o nome da instância.

• É necessário ter um api key criado.

• As operações da Wiki utilizam o Agent Scope completo de três segmentos (appId/tenantId/agentId). Cada segmento deve ser não vazio, não pode ser *, pode ter até 128 bytes de tamanho e não pode conter o caractere /. Não inclua o runId.

• As sources ficam armazenadas no diretório /.wiki/raw/, sob o memoryStoreName e o Agent Scope de três segmentos especificados. Tanto os uploads quanto as compilações utilizam o mesmo appId, tenantId e agentId, omitindo o runId em ambos os casos.

A operação AddItem grava os arquivos source da Wiki no diretório /.wiki/raw/ descrito acima, utilizando o mesmo Agent Scope de três segmentos da compilação e omitindo o runId. Isso representa uma exceção à regra de Scope para operações de arquivo, pois as demais operações exigem o Scope completo de quatro segmentos, incluindo o runId. Para mais detalhes, consulte Crie um arquivo. Exemplo de upload:

{
  "type": "memoryfile",
  "memoryStoreName": "agent_memory",
  "scope": {
    "appId": "app-001",
    "tenantId": "user-001",
    "agentId": "assistant"
  },
  "path": "/.wiki/raw/payment-spec.md",
  "content": "# Payment rules\nA refund requires the order number.\n"
}

Parâmetros da requisição

O parâmetro dreamActionRefs surte efeito apenas na compilação atual. As referências precisam pertencer ao mesmo repositório de memória e ao mesmo Agente, correspondendo a artefatos de Skill ou Profile aplicados que ainda estejam válidos. O sistema rejeita referências duplicadas.

Exemplo de requisição

Ao utilizar a autenticação por chave de api, informe o nome da instância e a chave de api nos cabeçalhos de requisição x-ots-instancename e x-ots-apikey.

curl -X POST https://<endpoint>/IngestWiki \
  -H "x-ots-instancename: <instance-name>" \
  -H "x-ots-apikey: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
  "memoryStoreName": "agent_memory",
  "scope": {
    "appId": "app-001",
    "tenantId": "user-001",
    "agentId": "assistant"
  },
  "clientToken": "payment-wiki-20260904"
}'

Resposta

{
  "status": "pending",
  "reused": false,
  "skipped": false
}

A compilação ocorre de forma assíncrona. Após iniciar o processo, consulte periodicamente o GetWiki e verifique o valor retornado em latestBuild.status até que ele mude para ready ou até que a compilação falhe. Caso não haja nenhuma source disponível, o sistema retorna o erro 400 VALIDATION_ERROR.