Yes, you can add notes as annotations via code in Phoenix. Notes are supported as a "Freeform" annotation type, which allows open-ended text comments to be attached to spans or traces programmatically using the Phoenix SDK or REST API. When creating an annotation, set the annotation type to "Freeform" and provide your note in the label or explanation field of the annotation payload. This can be done using the Python or TypeScript client, or by sending a POST request to the `/v1/span_annotations` endpoint with the appropriate fields for a freeform note. For example, you can include a note as the `label` or `explanation` in the annotation's `result` object when using the API or SDKs.
Would you like a code example for Python or TypeScript?
Sources:
- <https://arize.com/docs/phoenix/tracing/how-to-tracing/feedback-and-annotations/annotating-in-the-ui|Annotating in the UI>
- <https://arize.com/docs/phoenix/tracing/concepts-tracing/annotations-concepts|Annotations Concepts>
- <https://arize.com/docs/phoenix/tracing/how-to-tracing/feedback-and-annotations/capture-feedback|Annotating via the Client>
- <https://arize-ai.github.io/phoenix/functions/_arizeai_phoenix-client.spans_addSpanAnnotation.addSpanAnnotation.html|addSpanAnnotation | Arize Phoenix TS>
