> ## Documentation Index
> Fetch the complete documentation index at: https://docs.niadra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ferramentas da memória do agente

> `search_agent_memory` e `remember` como definições de função.



## OpenAPI

````yaml openapi/pt/cell.json GET /v1/agent-memory/tools
openapi: 3.1.0
info:
  title: API de dados da Niadra
  version: '1'
  description: >-
    Escrita, contexto, histórico, objetos, identidade, privacidade e governança
    de um espaço. Cada espaço tem um endereço estável, com o espaço e a região
    no nome.
servers:
  - url: https://{space}.{region}.api.niadra.com
    variables:
      space:
        default: acme-prod
        description: O espaço, que vem na chave de fonte.
      region:
        default: us-east-2
        description: A região do espaço, que também vem na chave.
security: []
paths:
  /v1/agent-memory/tools:
    get:
      tags:
        - agent-memory
      summary: Ferramentas da memória do agente
      description: >-
        `search_agent_memory` e, quando a chave pode escrever, `remember`, como
        definições de função. Vazio com a memória dos agentes desligada no
        espaço.


        **Autenticação.** Chave de fonte com o escopo `agent_memory` ou
        `context`, ou token de pessoa do Console com o papel `integration` (ou
        admin).
      operationId: tools_v1_agent_memory_tools_get
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/ToolDefinition'
                title: Response Tools V1 Agent Memory Tools Get
                type: array
          description: As definições, no mesmo formato de `GET /v1/history/tools`.
      security:
        - sourceKey: []
        - personToken: []
      x-codeSamples:
        - lang: python
          label: Python
          source: >-
            # The history kit plus search_agent_memory (and remember, with
            write_agent_memory=True)

            kit = conversation.tools(agent_memory=True, write_agent_memory=True)

            reply = llm.chat.completions.create(model=MODEL, messages=messages,
            tools=kit.definitions)
        - lang: typescript
          label: TypeScript
          source: >-
            // The history kit plus search_agent_memory (and remember, with
            writeAgentMemory: true)

            const kit = conv.tools({ agentMemory: true, writeAgentMemory: true
            });

            const reply = await llm.chat.completions.create({ model: MODEL,
            messages, tools: kit.definitions });
components:
  schemas:
    ToolDefinition:
      additionalProperties: false
      description: >-
        A definição de uma ferramenta de chamada de função, no formato JSON
        Schema mais difundido.
      properties:
        function:
          additionalProperties: true
          title: Function
          type: object
          description: '`name`, `description` e `parameters` (JSON Schema).'
        type:
          const: function
          default: function
          title: Type
          type: string
      required:
        - function
      title: ToolDefinition
      type: object
  securitySchemes:
    sourceKey:
      type: http
      scheme: bearer
      description: nia_sk_...
    personToken:
      type: http
      scheme: bearer
      bearerFormat: JWT

````