Listar os comentários de um artefato do run
As threads de comentário do artefato, com as respostas. Quando a âncora é um ponto numa prancheta que existe na versão atual, a thread traz `board`, `x` e `y` (frações de 0 a 1), para quem embute desenhar o marcador; senão os três vêm `null`. Numa página publicada comum, os comentários são só de quem a criou: para outras pessoas a lista vem vazia. Exige o escopo runs:read.
Authorization
chaveDeApi Chave de API da organização, criada nas configurações. Envie-a em Authorization: Bearer <sua chave>.
In: header
Path Parameters
Identificador do run. É o mesmo da conversa: um run continua na mesma thread.
Identificador do artefato.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/runs/string/artifacts/string/comments"{ "threads": [ { "id": "string", "anchor": "string", "label": "string", "board": "string", "x": 0, "y": 0, "resolved": true, "created_at": "2019-08-24T14:15:22Z", "comments": [ { "id": "string", "author": { "kind": "person", "id": "string", "name": "string" }, "text": "string", "created_at": "2019-08-24T14:15:22Z", "source_name": "string" } ] } ]}Trocar o compartilhamento de um artefato do run
O menu Compartilhar do painel pela API, com a mesma regra e a mesma permissão: quem criou o artefato, quem gerencia os agentes da organização ou quem configura o agente. O campo ausente fica como está. Na primeira ida para `public` o servidor gera o link; voltar a outro nível desliga o link na hora, e tornar público de novo devolve o MESMO endereço. O link público pode ser embutido numa moldura pelas origens das aplicações vinculadas ativas da organização (Configurações > Aplicações), com o app e os domínios da organização; quem abre embutido vê como visitante, só para ver. O tipo Dashboard não tem link público. Exige o escopo runs:execute.
Comentar num ponto de uma prancheta
Abre uma thread de comentário num ponto de uma prancheta de um canvas de design deste run, com a pessoa dona da chave como autora. Quem chama manda a prancheta e a fração do ponto (a conta está em POST /v1/runs/{runId}/artifacts/{artifactId}/embed); a âncora é gravada no formato do editor, então a thread aparece no canvas no mesmo ponto, com o título da prancheta como lugar. Quando a chave é de uma aplicação vinculada, o comentário leva essa aplicação, e o canvas mostra "pelo <aplicação>" ao lado da hora. O comentário NÃO acorda o agente: ele fica no canvas, e o agente o lê pela ferramenta de artefato quando o fluxo de quem chamou pedir. Exige o escopo runs:execute.