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

# Observations

> Review runtime findings that may need attention.

An Observation is a saved finding about something GroundForge saw while a request was running.

## Example

The latest Agent Discovery lists:

```text theme={null}
get_weather(city)
```

During a request, the Agent attempts to call:

```text theme={null}
get_hourly_forecast(city)
```

GroundForge can record an Observation because the runtime call does not match the latest discovered capability list.

Use the linked Trace to understand the request. Then check the Agent or MCP source. Run Discovery again only when the capability source has actually changed.

## CLI example

```bash theme={null}
gforge agents observations <agent-id>
```

Viewing Observations reads saved records. It does not contact or restart the Agent.

See [Discovery](/concepts/discovery), [Drifts](/concepts/drifts), and [Traces](/concepts/traces-analytics).


## Related topics

- [Review Runtime Observation](/api-reference/endpoints/review-runtime-observation.md)
- [Update Runtime Observation](/api-reference/endpoints/update-runtime-observation.md)
- [Get Runtime Observation](/api-reference/endpoints/get-runtime-observation.md)
- [List Agent Observations](/api-reference/endpoints/agents/list-agent-observations.md)