annotation_queue_interactions

Creates, updates, deletes, gets or lists an annotation_queue_interactions resource.

Overview

Name	annotation_queue_interactions
Type	Resource
Id	datadog.llm_observability.annotation_queue_interactions

Fields

The following fields are returned by SELECT queries:

SELECT not supported for this resource, use SHOW METHODS to view available operations for the resource.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
create_llmobs_annotation_queue_interactions	insert	queue_id, data		Add one or more interactions to an annotation queue. At least one<br />interaction must be provided. Each interaction has a type:<br /><br />- trace, experiment_trace, session: content_id references the<br /> upstream entity; the server fetches the actual content.<br />- display_block: omit content_id and provide the rendered content<br /> in display_block. The server generates content_id as a<br /> deterministic hash of the block list.<br /><br />Items of different types can be mixed in a single request.
delete_llmobs_annotation_queue_interactions	exec	queue_id, data		Delete one or more interactions from an annotation queue.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
queue_id	string	The ID of the Agent Observability annotation queue. (example: 00000000-0000-0000-0000-000000000001)
site	string	The Datadog site (region) for your organization, for example datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, ap1.datadoghq.com, ap2.datadoghq.com, datadoghq.eu, ddog-gov.com. Resolved from the DD_SITE environment variable when set. Optional: defaults to datadoghq.com, or the value of the DD_SITE environment variable when set; a WHERE value overrides both.

INSERT examples

create_llmobs_annotation_queue_interactions

Add one or more interactions to an annotation queue. At least one<br />interaction must be provided. Each interaction has a type:<br /><br />- trace, experiment_trace, session: content_id references the<br /> upstream entity; the server fetches the actual content.<br />- display_block: omit content_id and provide the rendered content<br /> in display_block. The server generates content_id as a<br /> deterministic hash of the block list.<br /><br />Items of different types can be mixed in a single request.

INSERT INTO datadog.llm_observability.annotation_queue_interactions (
data,
queue_id
)
SELECT 
'{{ data }}' /* required */,
'{{ queue_id }}'
RETURNING
data
;

Manifest

# Description fields are for documentation purposes
- name: annotation_queue_interactions
props:
  - name: queue_id
    value: "{{ queue_id }}"
    description: Required parameter for the annotation_queue_interactions resource.
  - name: data
    description: |
      Data object for adding interactions to an annotation queue.
    value:
      attributes:
        interactions:
          - content_id: "{{ content_id }}"
            type: "{{ type }}"
            display_block: "{{ display_block }}"
      type: "{{ type }}"

Lifecycle Methods

EXEC variables use wire (API) names.

delete_llmobs_annotation_queue_interactions

Delete one or more interactions from an annotation queue.

EXEC datadog.llm_observability.annotation_queue_interactions.delete_llmobs_annotation_queue_interactions 
@queue_id='{{ queue_id }}' --required, 
@@json=
'{
"data": "{{ data }}"
}'
;