add_observations

Add new observations to existing entities in a knowledge graph by specifying entity names and observation contents with a memory file path.

Instructions

Add new observations to existing entities in the knowledge graph

Input Schema

TableJSON Schema

Name	Required	Description	Default
`observations`	Yes
`memoryFilePath`	Yes	The path to the memory file

Implementation Reference

index.ts:155-174 (handler)

Core handler logic in KnowledgeGraphManager.addObservations: loads graph from file, finds entities, adds unique observations, saves updated graph, returns added observations per entity.

async addObservations(
  observations: { entityName: string; contents: string[] }[],
  filepath: string
): Promise<{ entityName: string; addedObservations: string[] }[]> {
  await this.setMemoryFilePath(filepath);
  const graph = await this.loadGraph();
  const results = observations.map((o) => {
    const entity = graph.entities.find((e) => e.name === o.entityName);
    if (!entity) {
      throw new Error(`Entity with name ${o.entityName} not found`);
    }
    const newObservations = o.contents.filter(
      (content) => !entity.observations.includes(content)
    );
    entity.observations.push(...newObservations);
    return { entityName: o.entityName, addedObservations: newObservations };
  });
  await this.saveGraph(graph);
  return results;
}

index.ts:400-433 (schema)

Input schema definition for the add_observations tool, specifying structure for observations array (with entityName and contents) and memoryFilePath.

{
  name: "add_observations",
  description:
    "Add new observations to existing entities in the knowledge graph",
  inputSchema: {
    type: "object",
    properties: {
      observations: {
        type: "array",
        items: {
          type: "object",
          properties: {
            entityName: {
              type: "string",
              description:
                "The name of the entity to add the observations to",
            },
            contents: {
              type: "array",
              items: { type: "string" },
              description: "An array of observation contents to add",
            },
          },
          required: ["entityName", "contents"],
        },
      },
      memoryFilePath: {
        type: "string",
        description: "The path to the memory file",
      },
    },
    required: ["observations", "memoryFilePath"],
  },
},

index.ts:634-652 (registration)

Registration in the tool dispatcher switch statement: handles CallToolRequest for add_observations by calling the KnowledgeGraphManager method and returning JSON-formatted result.

case "add_observations":
  return {
    content: [
      {
        type: "text",
        text: JSON.stringify(
          await knowledgeGraphManager.addObservations(
            args.observations as {
              entityName: string;
              contents: string[];
            }[],
            args.memoryFilePath as string
          ),
          null,
          2
        ),
      },
    ],
  };

Memory Custom