house-lights 1.3.0 → 1.4.0

package/skills/cast-list/examples/agents/bodega-orquestrador/actions/AgenteFrete.mcs.yml

@@ -2,23 +2,11 @@ mcs.metadata:
   componentName: Agente Frete
   description: Agente conectado Bodega Azul - Frete.
 kind: TaskDialog
-inputs:
-  - kind: ManualTaskInput
-    propertyName: CategoriaSolicitacao
-    value: =Global.CategoriaSolicitacao
-
 modelDisplayName: Bodega Azul - Frete
 modelDescription: "Agente especialista em frete e entregas: modalidades, prazos por região e frete grátis. Use quando a categoria for Frete."
 action:
   kind: InvokeConnectedAgentTaskAction
-  inputType:
-    properties:
-      CategoriaSolicitacao:
-        displayName: CategoriaSolicitacao
-        description: Categoria da solicitação definida pelo orquestrador.
-        isRequired: true
-        type: String
-
+  inputType: {}
   botSchemaName: cr7b2_bodegaFrete
   historyType:
-    kind: ConversationHistory
+    kind: NoHistory

package/skills/cast-list/examples/agents/bodega-pedidos/topics/Escalate.topic.mcs.yml

@@ -18,3 +18,8 @@ beginDialog:
     - kind: SendActivity
       id: sendMessage_X7qDFG
       activity: "A transferência para um atendente ainda não está disponível neste canal. Fale com a nossa equipe pelo e-mail pedidos@bodegaazul.example, de segunda a sábado, das 9h às 18h."
+
+    - kind: SendActivity
+      id: sendMessage_kDOncS
+      disabled: true
+      activity: "Aguarde, estamos transferindo você para um atendente."

package/skills/cast-list/examples/agents/bodega-pedidos/workflows/AbrirChamadoERP-7d1c2a4e/metadata.yml

@@ -0,0 +1,3 @@
+displayName: Abrir chamado no ERP
+workflowId: 7d1c2a4e-3b5f-4c6d-8e9f-0a1b2c3d4e5f
+jsonFileName: workflow.json

package/skills/cast-list/examples/agents/bodega-pedidos/workflows/AbrirChamadoERP-7d1c2a4e/workflow.json

@@ -0,0 +1,56 @@
+{
+  "properties": {
+    "displayName": "Abrir chamado no ERP",
+    "connectionReferences": {},
+    "definition": {
+      "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
+      "contentVersion": "1.0.0.0",
+      "triggers": {
+        "manual": {
+          "type": "Request",
+          "kind": "Skills",
+          "inputs": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "resumo": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        }
+      },
+      "actions": {
+        "Abrir_chamado": {
+          "type": "Scope",
+          "actions": {
+            "Chamar_ERP": {
+              "type": "Http",
+              "inputs": {
+                "method": "POST",
+                "uri": "https://erp.bodega-azul.example/chamados",
+                "body": "@triggerBody()"
+              }
+            }
+          }
+        },
+        "Responder": {
+          "type": "Response",
+          "kind": "Skills",
+          "runAfter": {
+            "Abrir_chamado": [
+              "Succeeded"
+            ]
+          },
+          "inputs": {
+            "statusCode": 200,
+            "body": {
+              "resultado": "@outputs('Resultado')"
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/skills/cast-list/references/format.md

@@ -55,3 +55,23 @@ A line deleted or a decision cleared is a change too.
                 "facts": { "trigger:OnUnknownIntent": [ { "file": "topics/Fallback.topic.mcs.yml", "line": 7 } ] },
                 "children": [], "unknown": [] } ] }
 ```
+
+An orchestrator's agent also has `contract` — a line per connected-agent action: `calls` (the schema name it calls),
+`name` (the action's name for it), `history` (it passes the conversation history), `inputs`, `description` (the
+routing description), `file` and `line` — and every agent has `flows`: `id` (the `workflowId`), `name`, `folder`,
+`uses` (`http:<host>`, `connector:<api>`, `operation:<api>/<op>`, `child-flow`), `returns`, `called` and `file`.
+
+## The facts of the contract, the flows and what nobody uses
+
+| Key | On which agent | From |
+|---|---|---|
+| `called-with:history` | the one called | the orchestrator's action has `historyType: ConversationHistory` |
+| `called-with:input:<name>` | the one called | each input the orchestrator's action passes |
+| `routing:described` | the one called | the action has a `modelDescription` |
+| `flow-uses:http:<host>`, `flow-uses:connector:<api>`, `flow-uses:operation:<api>/<op>`, `flow-uses:child-flow` | the one whose node calls the flow | the actions of `workflow.json`, at any depth |
+| `flow-returns` | the same | the flow has a `Response` action |
+| `orphan:topic:<name>`, `orphan:action:<name>`, `orphan:variable:<name>`, `orphan:flow:<name>` | the one that has it | nothing can reach it (see SKILL.md, step 2) |
+| `disabled:node:<kind>`, `disabled:<topic\|action\|variable\|knowledge>:<name>` | the one that has it | `disabled: true` on a node; `state` or `status: Inactive` on a component |
+
+The contract's facts cite the orchestrator's file (`<orchestrator>/actions/X.mcs.yml`). `orphan:` and `disabled:` are
+never a pattern nor a solo, and what an unused flow calls is not a fact.

package/skills/cast-list/references/keys.md

@@ -30,6 +30,11 @@ Every fact cast-list finds is a key. The keys below have a name; any other key k
 
 | Key | Name | Nome |
 |---|---|---|
+| `flow-returns` | The flow returns an answer | O fluxo devolve uma resposta |
+| `flow-uses:child-flow` | The flow calls another flow | O fluxo chama outro fluxo |
+| `flow-uses:http:<value>` | Flow calls <value> | Fluxo chama <valor> |
+| `flow-uses:connector:<value>` | Flow uses the connector <value> | Fluxo usa o conector <valor> |
+| `flow-uses:operation:<value>` | Flow uses the operation <value> | Fluxo usa a operação <valor> |
 | `connector:<value>` | Connector <value> | Conector <valor> |
 | `operation:<value>` | Operation <value> | Operação <valor> |
 | `connref:<value>` | Connection reference <value> | Referência de conexão <valor> |
@@ -58,6 +63,9 @@ Every fact cast-list finds is a key. The keys below have a name; any other key k
 | `trigger:OnRedirect` | Takes a call from the orchestrator | Recebe chamada do orquestrador |
 | `trigger:OnToolSelected` | Child chosen as a tool | Filho escolhido como ferramenta |
 | `setting:connectable` | Can be called by an orchestrator | Pode ser chamado por um orquestrador |
+| `called-with:history` | Receives the conversation history | Recebe o histórico da conversa |
+| `routing:described` | Has a routing description | Tem descrição de roteamento |
+| `called-with:input:<value>` | Receives <value> from the orchestrator <value> | Recebe <valor> do orquestrador <valor> |
 | `calls:<value>` | Calls <value> | Chama <valor> |
 | `child:<value>` | Child <value> | Filho <valor> |
 | `var-in:<value>` | Receives from the orchestrator <value> | Recebe do orquestrador <valor> |
@@ -72,6 +80,12 @@ Every fact cast-list finds is a key. The keys below have a name; any other key k
 | `instructions:present` | Has instructions | Tem instruções |
 | `node:LogCustomTelemetryEvent` | Logs telemetry | Registra telemetria |
 | `node:CSATQuestion` | Asks for satisfaction (CSAT) | Pergunta a satisfação (CSAT) |
+| `orphan:topic:<value>` | Topic nobody calls <value> | Tópico que ninguém chama <valor> |
+| `orphan:action:<value>` | Tool nobody can choose <value> | Ferramenta que ninguém escolhe <valor> |
+| `orphan:variable:<value>` | Variable nobody uses <value> | Variável que ninguém usa <valor> |
+| `orphan:flow:<value>` | Flow nobody calls <value> | Fluxo que ninguém chama <valor> |
+| `disabled:node:<value>` | Switched-off node <value> | Nó desligado <valor> |
+| `disabled:<value>` | Switched off <value> | Desligado <valor> |
 | `node:<value>` | Node <value> | Nó <valor> |
 | `model:<value>` | Model <value> | Modelo <valor> |
 | `auth:<value>` | Sign-in <value> | Login <valor> |